# How to Configure Your Astroneer Dedicated Server (AstroServerSettings.ini) (/docs/astroneer/server-settings) import { File, Folder, Files } from 'fumadocs-ui/components/files'; Astroneer uses **two config files** for server settings: > ⚠️ **Do NOT edit .ini files while the server is running.** Changes will not be saved. Always stop the server first. Editing Config Files [#editing-config-files] 1. Stop your server 2. In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Files** 3. Navigate to `Astro/Saved/Config/` (WindowsServer or LinuxServer depending on your setup) 4. Edit the file, save, and start your server > 📝 **Note:** If the config files don't exist, run the server once and shut it down — they auto-generate on first launch. *** Engine.ini — Connection Port [#engineini--connection-port] The game port is set in `Engine.ini`, not in AstroServerSettings.ini: ```ini [URL] Port=8777 ``` This tells Astroneer which port to listen on for player connections. You must also ensure this port is open (UDP) in your firewall. *** AstroServerSettings.ini — Complete Reference [#astroserversettingsini--complete-reference] Under `[/Script/Astro.AstroServerSettings]`: Server Identity & Network [#server-identity--network] | Setting | Default | Description | | ---------------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ServerName` | `"Astroneer Dedicated Server"` | Name in the server browser | | `ServerAdvertisedName` | `""` | Overrides ServerName for browser display if set | | `PublicIP` | `""` | Your server's public IP — required for the browser to list your server correctly. Use [Google "my IP"](https://www.google.com/search?q=my+ip) to find it. | | `ServerPassword` | `""` | Join password (blank = public) | | `Port` | `8777` | Game port (should match Engine.ini) | | `ConsolePort` | `1234` | Remote console port (TCP) — do NOT expose publicly | Players & Ownership [#players--ownership] | Setting | Default | Description | | ----------------------- | ------- | ------------------------------------------------------------------------------------------- | | `MaxPlayerCount` | `8` | Max concurrent players (**hard cap: 8**) | | `OwnerName` | `""` | Steam name of the server owner | | `OwnerGuid` | `""` | SteamID64 of the owner (auto-filled when owner first joins; set to `0` for auto-assignment) | | `PlayerActivityTimeout` | `0` | AFK kick timeout in seconds (0 = disabled) | | `DenyUnlistedPlayers` | `False` | Whitelist mode — only players in the approved list can join | > 💡 **Tip:** See [Server Ownership](/docs/astroneer/server-owner) for the full ownership setup guide. Save Management [#save-management] | Setting | Default | Description | | ------------------------------- | ------- | ------------------------------------------------------------ | | `ActiveSaveFileDescriptiveName` | `""` | Name of the active save file (without `.savegame` extension) | | `AutoSaveGameInterval` | `900` | Auto-save interval in seconds (900 = 15 minutes) | | `BackupSaveGamesInterval` | `7200` | Backup interval in seconds (7200 = 2 hours) | Save files are stored in `Astro/Saved/SaveGames/`. Backups are created in the same directory with timestamps appended to the filename. Other Settings [#other-settings] | Setting | Default | Description | | ------------------------- | ------- | --------------------------------------- | | `bDisableServerTravel` | `False` | Disable travel between planets | | `VerbosePlayerProperties` | `False` | Enable detailed player logging | | `ServerGuid` | `""` | Auto-generated unique server identifier | Required Ports [#required-ports] | Port | Protocol | Purpose | Required? | | -------- | -------- | ------------------------- | :----------------: | | **8777** | **UDP** | Game traffic | Yes | | 1234 | TCP | Console/remote management | No — internal only | > ⚠️ **Important:** Only port 8777 UDP needs to be forwarded. The ConsolePort should **never** be exposed to the public internet. Performance Notes [#performance-notes] * Astroneer servers consume **2–4 GB RAM** baseline, growing to **6 GB+** as bases become complex * Large bases with many tethers and items are the main performance bottleneck — this is an engine limitation * **Auto-save** during complex worlds can cause brief lag spikes — consider increasing `AutoSaveGameInterval` for large saves * Always stop the server gracefully — forced shutdowns during auto-save can corrupt the save file Example Configuration [#example-configuration] ```ini [/Script/Astro.AstroServerSettings] PublicIP=203.0.113.50 ServerName=XGaming Space Explorers MaxPlayerCount=8 OwnerName=MyUsername OwnerGuid=0 ServerPassword= AutoSaveGameInterval=900 BackupSaveGamesInterval=7200 ActiveSaveFileDescriptiveName=MyWorld DenyUnlistedPlayers=False PlayerActivityTimeout=0 Port=8777 ConsolePort=1234 ``` Related Guides [#related-guides] * [Server Ownership](/docs/astroneer/server-owner) * [How to Join Your Server](/docs/astroneer/join-server) * [Troubleshooting](/docs/astroneer/troubleshooting)