Rust Wiki

Revision Difference

rust-companion-server#529231

<cat>Play.Hosting</cat> <title>Rust+ Server</title> # About The Companion Server is what Rust+ uses to communicate with Rust servers. If something is wrong with it then nobody will be able to view your server in Rust+, even if they pair with it. They will see it loading for a while before it says the server is offline. # Making it work For most people, the only requirement for the companion server to work is to make the `app.port` TCP port accessible over the internet. Port forward, open it, add firewall rules for it. ⤶ The default port is the game port (28015) + 67, or the RCon port (28016) + 67, whichever is the larger number. If you are useing the default ports for the game AND RCon, it will be 28083. This port must be 10000 or greater for Rust+ to connect to it. If you have a more complicated networking setup where you need to specify which NIC to listen on then you'll need to set the `app.listenip` convar to its IP address. You can check the connection settings the server is currently using with the `app.info` command. If the IP address that the app connects to is incorrect, you can set it `app.publicip` to the value you need. For most people, the only requirement for the companion server to work is to make the TCP port the companion server listens on accessible over the internet. Port forward, open it, add firewall rules for it. ⤶ You can use the `app.info` command on your server to show what port the companion server is using. If you need to switch it to something else, you can specify the port to use in the `app.port` convar. This port must be 10000 or greater for Rust+ to connect to it. You will need to restart your Rust server for the port change to take effect. If you have a more complicated networking setup where you need to specify which NIC to listen on then you'll need to set the `app.listenip` convar to your Rust server's public IP address. You can check the connection settings the server is currently using with the `app.info` command. If the IP address that the app connects to is incorrect, you can set it `app.publicip` to the value you need. If you get errors about companion server registration or push notifications aren't working then make sure your server can access companion-rust.facepunch.com over the internet. If everything is still broken you can submit feedback [using this form](https://form.asana.com/?hash=050f6e1785b7ab30f75bc0765214aded9dc4bd3061666b80f08378c2ac8032a4&id=1177653515858997). # Checking if it works The most straight forward way to test is by pairing with the app itself - but if you have many servers there's an easier way. You can use [this tool](http://www.websocket.org/echo.html) (note: must not be HTTPS!) to test connections to the companion server. Simply type in the IP address and port that the app connects to into the "Location" field. For example: `ws://99.99.99.99:28082`. Press the "Connect" button and you'll see the results in the log to the right. The most straight forward way to test is by pairing with the app itself - but if you have many servers there's an easier way. You can use [this tool](http://www.websocket.org/echo.html) (note: must not be HTTPS!) to test connections to the companion server. Simply type in the Rust server's IP address and companion server port into the "Location" field. For example: `ws://99.99.99.99:28082`. Press the "Connect" button and you'll see the results in the log to the right. # The "companion.id" file You may have noticed a `companion.id` file in your server's save folder recently. This file represents your server's identity to Rust+ and should always be kept with your server and its backups. Here's a list of rules for this file: * Do not give it to anyone else. * Do not use someone else's file. * Do not use the same file on multiple servers. * Do not randomly delete it. * Do not change the "app.id" convar. Breaking any of those rules will make your server behave weirdly in Rust+, disable notification permission for all your players, and probably require all players to re-pair with your server. A brand new identity will be generated for your server if you do delete it. There's no getting it back once it's gone! # Disabling Rust+ on your server If you need to disable Rust+ on your server for whatever reason, the proper way to do so is to set `app.port` to -1 in your server command line (this was reported broken at release, you must set app.port after the server is running). This is the only way to turn it off entirely. Players will be able to see that Rust+ is disabled if they open the Rust+ menu on their clients while connected to your server. If you need to disable Rust+ on your server for whatever reason, the proper way to do so is to set `app.port` to -1 in your server command line. This is the only way to turn it off entirely. Players will be able to see that Rust+ is disabled if they open the Rust+ menu on their clients while connected to your server.