These Docs will be changed and improved over time, the Revolt system is still very new to our team.
To generate a container, you will need to specify an Operating System.
This can be done like so using Ubuntu as an Example:
>generate ubuntu
RevoltLinux.Starting Jan 1, 2023 all users on Revolt will be using our brand new upgraded bot.
When your very first container is generated, two things happen, we generate a unique SSHID which will serve as your user ID within our platform.
The bot then binds the current platform you are on to your SSH ID.
This ID is used when ordering upgrades.
You can see your ID using >my-id at anytime.
Each generated container has an expiration date which is seven (7) days after the container generated, and will be removed automatically after that.
Only the upgraded containers that has no expiration date.
If you want your free container to run longer than seven (7) days, you need to extend the container by running the extend command >extend to add seven (7) days from the date the command was ran.
We now have a web control panel at https://ctl.ssh.surf.
Login credentials to access this panel will be sent to you through Direct Message when you first create a container.
Note: Login credentials will only be sent once only. So, make sure you save your credentials somewhere safe.
If you do loose access, please contactsnxraven
This control panel has the ability to manage your container, such as:
You can also view the containers resource usage with easy to understand graphs, as well as the ability to view all the currently running processes.
You are provided with a randomly generated password through Direct Message once container generation has completed, however, you may wish to change this password.
Secure your container by running the following command:
echo "root:newpasswordhere" | chpasswd
You can also login via SSH and use passwd like this:
passwd root
Note: Please enable privacy mode using
/privacybefore submitting the command.
Commands sent via Revolt-Linux bots are non-interactive.
If a command requires user input the process will stall waiting.
This is a limitation of the Revolt API due to rate limits.
Once your container has been generated, you can submit commands to it, this can be done using the > command syntax.
Each container is linked using Revolt ID, so it’s not possible for other users to submit command as you, so your container is private.
Here is an example of the > command syntax
All users interact under the “root” user.
Just like any Linux Environment, you will need to browse the filesystems directories and create files and directories.
In this example, we are going to change to the root directory of the container:
> cd / OR >cd /
Upon your first few uses of the containers, you will see start.sh in the root directory of the container
This script is called when the container boots up, this is where you define your systemctl service starts or any commands you would like to run during boot time.
Here I will break down each line in the stock file:
#!/bin/sh < – Tells the system to use SH
export CID=$(basename $(cat /proc/1/cpuset)) < — Container ID as a system VAR
service ssh start < — This starts the SSH Server on boot
sh /var/tools/getsystemctl.sh < — Replacement for systemctl which is required
tail -f /dev/null <— To keep the container running! DO NOT REMOVE!
You can write files to your container using the following “Hello World Example”
^write {
console.log("Hello, World")
}
^hello.js^
This will create the hello.js file within the current working directory.
If you would like to register a subdomain to be used as a hostname for your container, you can use our custom Hostname Generator
There are only two steps involved:
Step 1) Register a subdomain:
+add-surf (subdomain)
Once the domain is registered, the last step is to map the subdomain to a port.
+vhost-surf (subdomain) (port)
Your URL will be ready to be used.
Local Ports
You can assign a VHOST to any local port you have listening within the container.To do so so with our ssh.surf subdomains use the following syntax:
+vhost-local-surf (subdomain) (port)This will map your port and let you know the URL is ready.
Our DNS Node has been decommissioned as of March 7th, 2023.
The following instructions detail how to use your own domain with our services.
We recommend moving your domain to https://cloudflare.com if it’s currently in our Panel.
You have the option to use your registrar’s DNS settings or any other free DNS service available.
Our IP Address is:
132.145.188.157Please set your A Record for your domain accordingly.
CNAME Records are currently NOT supported, please ensure you have an A record as noted above.
An update will be posted here once this support is added.
Step 1) To generate an account to access our built in DNS panel, type the following command:
+register-domain
The user account details will be sent to you in your Direct Messages
Step 2) Generate an SSL Certificate once DNS has propagated. (REQUIRED)
+domain-certificate (domain)
Step 3) Lastly, you will want to map the URL to a port:
+vhost-domain (domain) (port)
Your URL will then be ready for use
Local Ports
You can assign a VHOST to any local port you have listening within the container.To do so so with our ssh.surf subdomains use the following syntax:
vhost-local-domain (domain or subdomain) (port)This will map your port and let you know the URL is ready.
You may find that you want to use the CloudFlare Proxy and allow CloudFlare to generate and manage certificates for your URLs automatically.
To do so, create the A record for your domain or subdomain as needed within CloudFlare while leaving the Cloud “Orange” to enable the proxy.
Use the command +vhost-domain-cf domain.com PORT to generate a vhost compatible with CloudFlare.
Make sure your SSL Settings are set to
FULL
You can now upload files within Revolt-Linux using the Upload channel within our server, this feature is limited to your accounts upload limits.
An attachment is required.
WARNING: All files uploaded using
/uploadwill also enter Revolts’s CDN
DO NOT UPLOAD SENSITIVE FILES OR DATA TO THIS SERVICE.
Each container gets a set of 4 ports open, one is dedicated to SSH and is binded to port 22 on your container, the other is dedicated to HTTP Server and that is binded to port 80 on your container.
You can check open ports using:
>ports
You can check your container resource usage within Revolt using >stats
Say that if you want to start all over brand new, that is easy for our system to handle, simply use the >destroy command to destroy and remove your existing container and then, you can use >generate again to start fresh!
Note: Running this command will remove all of your existing data in the container, please think twice if you really want to run this command.
We offer container upgrades at our upgrade store https://store.discord-linux.com/
Before purchasing an upgrade at our store, please ensure you have a container running within Revolt-Linux.
Any key that expires gets automatically removed from the system and the container will be reset to default limits. Upgrades can be purchased at any time.
If you would like to donate to help keep our services online and provide much more powerful machines, please consider purchasing a container upgrade, or donate to us through the donation page below:
Any donations are very much appreciated.