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
/privacy
before 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.
Utilize our Web Proxy to host content within your container effortlessly. Follow these steps to bring your website online:
Step 1: Register an Account with Our Proxy Service
To begin, register an account with our proxy service by visiting:
>register-vhost-account
You will receive your login details via direct message. Please make sure to save these details for future reference.
If you already have an account and you are coming from another platform, please run this command again.
The service will copy your user configurations for use within Revolt.
Ensure that you have a webserver up and running.
Step 2: Generate a VHOST within Our Proxy System
Execute the following command:
>create-vhost domain.com PORTHERE
This will present the above form, you may provide your own domain or to claim a subdomain provided from us, you may register any-subdomain.ssh.surf OR *.ssh.surf
Lastly, tell the proxy what port within your container is listening for your service.
During registration an SSL Certificate will automatically be generated for your VHOST.
You may find the VHOST and the SSL Certificate within your provided web panel account.
The following domains are avalible for use with any subdomain:
ssh.surf
,shells.lol
,hehe.rest
,dcord.rest
,secure-shell.live
,nodejs.lol
,tcp.quest
Want to make a quick IP update or Port change to a VHOST?
Simply rerun the>create-vhost
command to update via the bot.
Please do not change your password within the proxy panel at this time.
A command will be provided to change your password soon.
To remove a VHOST from your account simply run the following command:
>delete-vhost example.com
This will remove both the VHOST and the certificate for it.
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
/upload
will 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
Service URL: https://secret.ssh.surf/
Built into the service is a free to use secret service, this service allows you to easily share sensitive information like passwords
, authentication data
or tokens
fully encrypted.
When using this service all data is encrypted by the container before sending a request, this ensures your data cannot be seen by anyone, even our network admins.
The binary for the service is called sec
You can interact with this in 2 ways via CLI as well as the website:
Program PIPE:
root@SSH32345643456:/# echo "hello" | sec
Secret is now available at:
https://secret.ssh.surf/#23fc2f8d-7a11-4942-aad4-db2917d0005a%7CgksaOYP7LKKgG9uYlOCU
Program Argument
root@SSH32345643456:/# sec "hello"
Secret is now available at:
https://secret.ssh.surf/#46fe99bd-adb4-49b8-9342-8fbe6c1913ba%7CwNtBYnlBSghUFTwvCyXN
You may view the clients raw bash script to ensure encryption here: https://ssh.surf/sec
PLEASE NOTE: Once a secret has been viewed it will self destruct.
Make sure to tell the receiving party to save their secret data.
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.
At SSH.Surf, we are dedicated to keeping our services online and offering even more powerful machines to our users. Your support can play a pivotal role in helping us achieve this mission.
Here are two meaningful ways you can contribute:
Container Upgrades: Enhance your own experience while supporting our services by purchasing a container upgrade. Enjoy additional resources and features while ensuring the sustainability of our platform.
Donations: If you’re feeling particularly generous, you can make a direct donation through the link below. Your contribution, no matter the size, goes a long way in helping us provide the best possible service to our community.
Your support matters, and we sincerely appreciate your commitment to our cause. Together, we can continue to deliver top-notch services and empower users like you. Thank you for standing with us!