Standard Appliance Deployment

This tutorial guides you step-by-step through the deployment of your Reemo appliance on a single machine. Ensure you have validated the hardware and network prerequisites before starting.

Selecting a new provider in Appliance mode

Step 1: Create the provider in the portal

Declare your infrastructure in the Reemo portal to obtain your configuration.

  1. From the Instance Administration Console, go to Container providers.

  2. Click New provider > Appliance mode provider. Standard mode is enabled by default.

  3. Fill in the required information, such as the provider’s name and visibility.

  4. (Optional) If you have enabled other specific settings (such as custom signaling servers), click Next and follow the interface prompts to configure these additional screens.

  5. Click Create to validate.

Creating a standard appliance container provider

Step 2: Retrieve the configuration file

  1. Open the newly created provider’s page.

  2. Click the Generate appliance configuration button.

  3. (Optional) Provide a custom certificate in the modal if your company requires it.

  4. Click Download. The config.json file will download to your workstation.

  5. Transfer this file to the target host server(s) (in the directory from which you will run the installation).

Generating the configuration file

Step 3: Verify connectivity on the server

Connect via SSH to your host server and run these quick tests to confirm that your outbound flows are properly opened:

curl -k --connect-timeout 5 https://preprodreemo.cloud.reemo.io:8444/
curl -I --connect-timeout 5 https://registry.reemo.io/v2/
nc -zv turn.cloudflare.com 3478

If any command fails (timeout), fix your firewall before proceeding.

Step 4: Run the installation

curl -fsSL https://download.reemo.io/appliance/appliance.sh | sudo bash -s -- \
  -u YOUR_USERNAME \
  -p YOUR_PASSWORD \
  install

These credentials allow your appliance to fetch sandbox images (chromium, ssh, etc.) from the Reemo registry.

Step 5: Verification

Once the installation is complete, check the status:

sudo bash appliance.sh status

You should see all three services in a running state:

[✓] applianceprovision : running ✓
[✓] applianceproapi    : running ✓
[✓] applianceproxy     : running ✓

Return to the Reemo portal. Your appliance should now appear with the Active status.

Next step: Operations and Maintenance

Now that your appliance is functional, consult the maintenance guide to manage its lifecycle (updates, logs, advanced options).