Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
Skip to content
World desk9 min

How to Add an Admin to a Factorio Server

Use Factorio’s /promote command for an immediate admin change, or maintain usernames in server-adminlist.json. This guide covers headless servers, custom paths, demotion, verification, and troubleshooting.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The reliable way to make someone an administrator on a Factorio server is to run the /promote command with that player’s exact name. An existing administrator can run it in-game; if nobody has admin rights yet, run it from the server’s own console. To remove access, use /demote. You can also manage several administrators with the server’s server-adminlist.json file.

The admin list is separate from server-settings.json. By default, server-adminlist.json is kept beside factorio-current.log. A headless server can use another location when it is started with --server-adminlist FILE.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What Factorio admin rights control

A Factorio administrator can use privileged server commands and manage multiplayer administration. Because the role is powerful, grant it only to people you trust and use the least complicated method that fits your situation.

Factorio documents two supported ways to maintain the administrator list:

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.
  • Use the console commands /promote, /demote, and /admins.
  • Edit the server’s server-adminlist.json file, or point the server to a file at a custom path with --server-adminlist FILE.

The command method is the safest choice when you need to promote one person immediately. The file method is useful when you are preparing a list for a headless server or maintaining several names outside the game.

Before you promote anyone

Get the player’s exact Factorio name

Use the name Factorio displays for the player, not a nickname from a hosting panel, chat service, or operating-system account. Names containing spaces or unusual characters should be copied exactly. If the command cannot find the player, verify the spelling and capitalization first.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Confirm that you have an administrative route

The promote, demote, and admins commands are admin-only commands. An existing administrator can issue them from the game console. If the server currently has no administrator, use the dedicated server’s own console or terminal rather than trying to execute an admin-only command as an ordinary player.

Make a maintenance backup

Before editing an administrator-list file, make a copy of it. Keep the backup outside the live configuration directory and record which file the server is actually using. This gives you a recovery path if the JSON becomes invalid or a panel overwrites it.

Method 1: promote a player with the console

This is the direct method for a running server and normally takes effect as soon as the command succeeds.

  1. Join the Factorio server with an account that already has administrative rights, or open the server’s own console if no in-game administrator exists.
  2. Open the Factorio console. In the game, use the console key configured for your keyboard and open a chat/console command line.
  3. Enter the promote command with the player’s exact name:
    /promote <player-name>
  4. Submit the command and read the server response. A successful response confirms that the player has been promoted.
  5. Verify the current list with:
    /admins

Replace <player-name> with the real account name and do not include the angle brackets. For example, the command pattern is /promote Alice when the player’s displayed name is Alice.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

Promoting someone who is online

Run the command while the player is connected, then have the player reconnect or continue playing according to the server’s response. The authoritative check is the output of /admins, not a hosting panel’s cached status.

Promoting someone who is not online

If the command accepts the exact name, it can be used from the server console without waiting for the player to join. If Factorio cannot resolve the name, use the file method only with care: an unverified report from a 2019 forum discussion suggested that file entries may be applied when a player is first created on joining, so editing the file alone may not promote an account that already exists. That behavior was not confirmed against the forum post or current documentation. For an existing account, the console command is the dependable fallback.

If you are setting up the first administrator

Connect to the dedicated server process through its own console and run /promote <player-name> there. Do not depend on an in-game command issued by a regular player: the promote command is restricted to administrators, while the server’s own console is the administrative control point.

Remove admin rights with demote

To revoke a player’s administrator access, run:

/demote <player-name>

  1. Run the command from an existing administrator account or the server console.
  2. Use the player’s exact displayed name.
  3. Run /admins to confirm that the name is no longer listed.

Demotion is preferable to deleting unrelated configuration files because it changes only the target player’s administrator status.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Method 2: manage the list in server-adminlist.json

Factorio’s documented administrator-list file is server-adminlist.json. It is not the same file as server-settings.json.

Find the correct file

By default, place or find server-adminlist.json in the same directory as factorio-current.log. The log’s location is therefore a practical way to identify the server’s active data directory. A file in a different directory will not be used unless the server was launched with a custom administrator-list path.

Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Understand the JSON structure

The file contains a JSON array of usernames. A two-user list looks like this:

["Alice", "Bob"]

An empty list is represented by:

[]

Keep the file valid JSON: use double quotation marks around each name, separate entries with commas, and do not add a trailing comma after the last entry. Preserve the names exactly as Factorio identifies them.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Edit the file safely

  1. Stop or place the server in a controlled maintenance state before changing the live file, and keep the backup you made earlier.
  2. Open the active server-adminlist.json in a plain-text editor.
  3. Add the new username as another quoted item in the top-level array. Do not replace the existing names unless you intend to remove their rights.
  4. Save the file as plain text with the exact filename server-adminlist.json.
  5. Check that the result is valid JSON and that the file is in the directory beside factorio-current.log, unless a launch parameter specifies another path.
  6. Start the server or apply the change during your provider’s supported maintenance procedure.
  7. After connecting, use /admins to inspect the list.

The official wiki describes this file as being created when a player is promoted through the console. If no file exists, promoting a player from the console is the most straightforward way to create the server-managed list before making further edits.

Is a restart required?

The available official descriptions identify the file and its location but do not establish a universal restart rule. Third-party summaries commonly say that a restart is needed after a file edit, but that requirement is not confirmed here. Use a controlled restart when your operating procedure permits it, then verify with /admins. If you need a change without downtime, use /promote from the server console instead.

Use a custom path on a headless server

A headless server can be told which administrator-list file to use with the launch parameter:

--server-adminlist FILE

Replace FILE with the path to the JSON file you want Factorio to read. This option is useful when your service keeps configuration outside the directory containing factorio-current.log, or when a deployment system maintains a dedicated configuration location.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Checklist for a custom file

  • Confirm that the launch command or service definition includes --server-adminlist.
  • Verify the path points to the file you edited, not an older copy.
  • Ensure the process user can read the file.
  • Keep the contents as a JSON array of usernames.
  • After starting the server, verify the result with /admins.

If the parameter is removed later, Factorio returns to its default file-location behavior, so document the setting with the rest of the server’s launch configuration.

Do not use server-settings.json for this

Some unofficial user-written guidance says that a headless server can be started with multiple administrators by editing server-settings.json. That advice conflicts with the official Multiplayer documentation and with current server-management discussions that identify server-adminlist.json as the administrator list.

Treat server-adminlist.json as the authoritative file for this task. Keep gameplay and server options in server-settings.json, and keep administrator usernames in the dedicated admin-list file. Editing the settings file may leave the actual admin list unchanged and makes troubleshooting harder.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Console command or file: which should you choose?

Method Best use What you change Important limitation
/promote Immediate promotion on a running server The server’s administrator list Must be issued by an existing administrator or from the server console
/demote Immediate removal of one player The target player’s administrator status Must be issued by an existing administrator or from the server console
server-adminlist.json Maintaining a prepared list or several names A JSON array of usernames File application timing and restart behavior are not fully established in the available official description
--server-adminlist FILE Headless deployments with a non-default configuration path The file path Factorio reads The launch configuration must remain in place

For a single player who needs access now, choose /promote. For repeatable server deployment, keep a valid JSON list under version control or in your configuration system and explicitly set --server-adminlist when the file is outside the default directory.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Hosting panels and managed servers

Many hosting control panels expose an “admins” or “administrator list” field. The panel may write the JSON file for you, but labels and paths vary by provider. Confirm which Factorio launch command the panel uses and whether it supplies --server-adminlist. If the panel reports that a user is an admin but /admins does not list that name, inspect the active file and launch arguments rather than assuming the panel’s display is authoritative.

When a panel provides a built-in console, the same Factorio commands apply: enter /promote <player-name>, /demote <player-name>, or /admins in that console. Provider documentation is secondary to the server’s actual command output and active configuration.

Troubleshooting admin promotion

The promote command says the player cannot be found

  • Copy the exact in-game name, including spaces, punctuation, and capitalization.
  • Make sure you are connected to the intended server and not a different save or instance.
  • If the player has never joined and the command cannot resolve the name, add the name to the JSON list and verify after the player joins, or use the server console when the account becomes available.
  • For an existing player who is not promoted by a file edit, use the console command; the reported join-time behavior of file entries is not confirmed for the current version.

The command is rejected for lack of permission

The promote, demote, and admins commands are admin-only. Ask an existing administrator to run the command, or use the dedicated server console. A player who has not yet been promoted cannot bootstrap their own privileges through in-game chat.

The file is ignored

  • Check the filename: it must be server-adminlist.json.
  • Check the directory: by default it is beside factorio-current.log.
  • Check the launch arguments for --server-adminlist FILE; if present, edit the file at that path instead.
  • Open the file and verify that it is a JSON array, with quoted names and commas in the right places.
  • Confirm that the server process can read the file.
  • Restart through the normal maintenance procedure if your deployment requires configuration reloads, then run /admins.

The JSON became invalid

Restore the backup, or replace the contents with a minimal valid array such as [] and add names one at a time. Do not attempt to repair a malformed file by adding comments: standard JSON does not allow them. If the server is running, use the console method after recovery so the server can recreate or update its managed list.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The panel and the game show different administrator lists

Use /admins in the running server as the immediate check. Then compare the panel’s configured path, the actual --server-adminlist argument, and the file beside factorio-current.log. A panel can be editing one copy while Factorio reads another.

A promotion worked, but the player still cannot use an admin command

Run /admins again and confirm the exact name appears. Have the player reconnect if the server or client does not reflect the new privilege immediately. If the name is absent, repeat /promote from the server console using the exact displayed name.

Operational and security practices

  • Grant administrator rights only to people who need them; the role permits privileged server actions.
  • Keep a backup of server-adminlist.json before bulk edits.
  • Document whether the server uses the default file beside factorio-current.log or a custom path supplied by --server-adminlist.
  • After every change, verify with /admins rather than relying solely on a control-panel indicator.
  • When someone no longer needs access, use /demote and confirm the removal.
  • Recheck the official Factorio Console and Multiplayer documentation after a major game-version change. The available documentation does not indicate a mechanism change in 2026, but command behavior should be validated against the version you operate.

Quick reference

/promote <player-name>
/demote <player-name>
/admins

Use /promote for an immediate, targeted change; use server-adminlist.json for a maintained list; and use --server-adminlist FILE when a headless server stores that list at a custom path.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.