|zeus 1a5c60c738 gitignore||21 hours ago|
|dist||22 hours ago|
|docs||9 months ago|
|files||9 months ago|
|hybrid||11 months ago|
|install||9 months ago|
|keys||11 months ago|
|nginx||10 months ago|
|public||8 months ago|
|src||22 hours ago|
|src-local||5 days ago|
|test||10 months ago|
|.gitignore||21 hours ago|
|Dockerfile||10 months ago|
|Dockerfile.backup||10 months ago|
|Dockerfile.build||11 months ago|
|LICENSE||11 months ago|
|README.md||7 months ago|
|down.sh||9 months ago|
|ecosystem.config.js||10 months ago|
|ecosystem.config.js.backup||10 months ago|
|install.sh||6 days ago|
|package-lock.json||9 months ago|
|package.json||9 months ago|
|restart||8 months ago|
|restart.sh||9 months ago|
|run.yml||9 months ago|
|run.yml.backup||10 months ago|
|run.yml.sh||9 months ago|
|start||8 months ago|
|start.sh||6 days ago|
|status.sh||9 months ago|
|stop||8 months ago|
|stop.sh||10 months ago|
|update-agent.sh||9 months ago|
Swarmlab hybrid provides the user with the unique abillity to create Labrooms (or other applications) and share them as project images expanding the simple swarmlab Labrooms to full-blown systems. An all of that using onlly the browser and the command line of their system.
Ever imagined having a normal lesson as you would in the University from the comfort of your livingroom?
Ever created a service that you would like to test on a real-world network?
Ever designed an Labroom/application you would like to distribute to your students/applications?
Swarmlab Hybrid comes to bridge the gap between tutor and student, the coder/developer of a service and the and user and at the same time meet the needs for a real-world testing environment.
With Hybrid we can now as part of the cloud work independantly but also stay connected.
The hybrid format allows us to utilize the power of Swarmlab itself but also combine it with the practiaclly unlimited computing of our own machines.
How does Swarmlab Hybrid differ from Swarmlab? Well…its Swarmlab…just….HYBRID!
Easy enough right? But what does that mean in practice?
Well for us it means a couple million more lines of code. For you it means a few more installation steps and the newfound access to YOUR OWN RESOURCES!
You will be connected to the Swarmlab Cloud (hence HYBRID) but you will be able to use your own storage(move files around, delete/copy etc),your own networking and computational power(cpu/graphics etc) and create a system exactly the way you need it.
This way you will be able to :
Normally the docker dataflow is as described in the following images:
To make the service easier to use we have created an ever-growing database of readilly accessible images you can choose from, thus making the first step optionall!
:exclamation: If you wish to use the service in Hybrid mode, that is if you want to share, download or perform other activites on the cloud you will need a KEY. Read installation instructions to learn how to do that.
Local usage of the service doesnt require one, you only need to log in to your account.
Before you create and configure a hybrid deployment using the swarmlab-agent client, your Local Machines need to meet certain requirements.
If you don’t meet those requirements, you won’t be able to complete the steps within the swarmlab-agent client and you won’t be able to configure a hybrid deployment between your Local Enviroment and Swarmlab Online Enviroment.
:warning: Since Docker uses hypervisor the host NEEDS TO HAVE VIRTUALIZATION ENABLED!
curl -sL https://deb.nodesource.com/setup_15.x | sudo -E bash - sudo apt-get install -y nodejs
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" sudo apt update sudo apt install -y docker-ce sudo usermod -aG docker [USERNAME] # Please replace [USERNAME] with the user you want to run docker on
:information_source: for kali specifically please visit the following link to install docker.
sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
sudo npm install -g pm2
sudo apt install wireguard jq
git clone --recurse-submodules https://git.swarmlab.io:3000/zeus/swarmlab-hybrid.git
cd swarmlab-hybrid ./install.sh <-- run it without root privileges
You can find ready to run VM images here.
:information_source: Default password: swarmlab
PLEASE CHANGE PASSWORD IMEDIATELLY AFTER FIRST LAUNCH!!!
:exclamation: No matter your distribution, upon installing you will HAVE to load settings before the first run!!
This will initialize the configuration using the system defaults.
Afterwards you can add custom settings, or keep using the defaults.
This action does NOT need to be repeated unless you wish to reset the application.
Please navigate to the “Profile->Settings” menu and click on the “Load settings” button.
After doing this the application MUST be reastarted! To do that please run the restart script.
inside the root directory of the project run
You can find our docs in docs Directory
The Swarmlab docs are in AsciiDoc (similar to markdown), PDF and html format
For real-time rendering in browser Asciidoc an add-on can be found here: