Guide · Setup
How to install Oxide plugins on a Rust server over SFTP
Installing an Oxide or Carbon plugin comes down to getting one C# file into the right folder. Here's the whole workflow — download from uMod, Codefling, or Lone.Design, upload the .csfile over SFTP/FTPS, and load it with RCON — plus what to check when a plugin won't load.
TL;DR
Download the plugin's .cs file → connect over SFTP/FTPS → drop it in oxide/plugins (or carbon/plugins) → it auto-compiles, or run oxide.reload <name> → verify with oxide.plugins.
Before you start
- Oxide (uMod) or Carbon is already installed on the Rust server.
- You have SFTP/FTPS access — host, port, username, and password from your host panel.
- RCON is enabled if you want to reload plugins without waiting for auto-compile.
Step-by-step: install a plugin over SFTP
- 1
Get your server's SFTP/FTPS details
From your host's control panel (Pterodactyl, TCAdmin, or a managed game host), copy the SFTP or FTPS host, port, username, and password. Any host that gives you SFTP/FTPS access will work, including self-hosted servers on Docker, LGSM, or bare metal.
- 2
Download the plugin
Grab the plugin from its marketplace — uMod for free plugins, or Codefling and Lone.Design for paid ones. Rust plugins are C# files ending in .cs. If the download is a .zip, extract it first and keep the .cs file.
- 3
Connect to the server over SFTP/FTPS
Open an SFTP/FTPS connection to the server with the credentials from step 1. Rust Server Admin connects for you, or you can use any SFTP client — the destination folder is the same either way.
- 4
Upload the .cs file into the plugins folder
Drop the .cs file into oxide/plugins for an Oxide (uMod) server, or carbon/plugins for a Carbon server. On many managed hosts the full path is /home/container/oxide/plugins or /home/container/carbon/plugins.
- 5
Let it load, or reload over RCON
Oxide and Carbon watch the plugins folder and compile new .cs files automatically within a few seconds. To load it immediately, run oxide.reload <PluginName> (or carbon.reload <PluginName>) from the RCON console.
- 6
Verify and configure the plugin
Run oxide.plugins in RCON to confirm the plugin loaded without compile errors. Most plugins generate a config file under oxide/config and language files under oxide/lang on first load — edit those, then reload to apply your settings.
Configuring the plugin
Most plugins create a config file at oxide/config/<PluginName>.json and, if they show text to players, language files under oxide/lang. Edit those over the same SFTP connection, then run oxide.reload <PluginName> to apply your changes. Grant any permissions the plugin defines with oxide.grant from RCON.
Troubleshooting
- Plugin not listed after upload? Confirm the file is a .cs (not a .zip) and landed in oxide/plugins or carbon/plugins.
- Compile error in console? The plugin likely targets a different Rust/Oxide version — grab the latest release from the marketplace.
- Uploaded to the wrong path? Managed hosts often nest the folder under /home/container — check the full path in your panel.
- Changes not applying? Reload the plugin over RCON after editing its config or lang files.
FAQ
- Where do Oxide plugins go on a Rust server?
- Oxide (uMod) plugins go in the oxide/plugins folder. Carbon plugins go in carbon/plugins. The plugin file must be the C# source file with a .cs extension — that is what Oxide and Carbon compile at runtime.
- Do I need to restart the server to install a plugin?
- No. Oxide and Carbon hot-load new .cs files from the plugins folder automatically, usually within a few seconds. If you want it loaded instantly, use oxide.reload or carbon.reload over RCON — a full restart is not required.
- My plugin didn't load after uploading — what's wrong?
- Check the RCON console for a compile error. The most common causes are uploading to the wrong folder, uploading a .zip instead of the extracted .cs file, or a plugin built for a different Rust/Oxide version. Confirm the file is a .cs in oxide/plugins and that its version matches your current Oxide or Carbon build.
- Can I install Codefling and Lone.Design plugins the same way?
- Yes. Free uMod plugins and paid Codefling or Lone.Design plugins all install the same way — the only difference is where you download the .cs file. Rust Server Admin can pull from all three and upload over SFTP for you.
Next: once plugins are installed, learn how to update Oxide & Carbon plugins after a force wipe.
Install and update plugins without the FTP client
Rust Server Admin downloads from uMod, Codefling, and Lone.Design and uploads to your oxide/plugins folder over SFTP — with a live RCON console to load and configure them.