# Install Buttons and get started

> Download and install Buttons, open the Editor UI over HTTPS, allow access from other computers and create the first administrator account.

Install Buttons, open its web interface securely, and create the first administrator account. Download Buttons Sign in at user.bitfocus.io and open the Downloads page . Download the current Buttons v1.8 build for the computer that will run Buttons. Buttons is available for: macOS Windows Linux Enterprise licenses can also run Buttons as an HA deployment. In this setup, Buttons runs on three machines and keeps running if one of them fails. HA is a separate, advanced installation path; do not follow the single-machine steps below as deployment instructions for an HA cluster: see Deploy Buttons with High Availability instead. See Choose an installation path if you're not sure which of these options fits your situation. Use the installer or package provided for your operating system. Start Buttons on macOS or Windows Open Buttons after installation. The watchdog window starts and monitors the services that make up Buttons. Use the watchdog window to: See whether the Buttons services are starting or running. Open the web interface with Launch Editor UI . Restart a service if it has stopped. Open Environment Settings . Reset the administrator password when you have access to the host computer. Shut down Buttons cleanly. Keep the watchdog running while you use Buttons. Closing Buttons from the watchdog stops the services and makes the Editor UI and operator controls unavailable. Start a headless Linux system The Linux build can run without a desktop window. In headless mode, the watchdog runs from the command line and supervises the same Buttons services. The downloaded Linux package includes its current startup instructions, command-line help, and a service example. Follow those instructions to choose whether Buttons listens only on the Linux host or on every network interface. HTTPS normally uses port 4443 ; if you change the web ports, confirm the resulting HTTPS port with ./watchdog-cli -help , see the startup configuration reference for the full flag list. For a permanent installation, adapt the supplied service example to your environment. Open the Editor UI Buttons uses a web interface. Open it over HTTPS in a modern version of Chrome, Edge, Firefox, or Safari. Chrome is recommended. On the Buttons host, select Launch Editor UI in the macOS or Windows watchdog. On a headless system, open: https://localhost:4443 Buttons automatically generates a self-signed certificate so HTTPS is available on a fresh installation. Because your browser does not automatically trust this certificate, it may display a certificate warning the first time you connect. Confirm that you are opening the intended Buttons host before continuing. From another computer or tablet on the network, use the Buttons host's hostname or IP address, for example: https://buttons-studio.example:4443 https://192.0.2.20:4443 Do not enter 0.0.0.0 in the browser. It is a listen address used by the Buttons host, not the address of the host itself. The fresh-install HTTPS port is 4443 . Existing installations can retain a different port after an upgrade or migration. Allow access from other computers On macOS and Windows, open the menu beside Launch Editor UI in the watchdog and select Environment Settings . Under Editor Listen Address , choose: Local machine only (127.0.0.1) : only browsers running on the Buttons host can connect. All interfaces (0.0.0.0) : browsers on other machines can connect through a reachable address or IP of the Buttons host. Environment Settings also contains: Editor HTTPS Port : the port on which Buttons accepts direct HTTPS connections. The fresh-install value is 4443 . Buttons Hostname : the hostname through which Buttons is available, such as buttons-studio.example . Buttons External Address : the complete HTTPS URL people use to reach Buttons. Buttons uses this address when opening the Editor UI and redirecting after login. It is also required by features that need a stable external origin, including SSO callbacks and passkeys. For a direct connection on the default HTTPS port, the external address would be: https://buttons-studio.example:4443 If an approved reverse proxy exposes Buttons at the standard HTTPS port, the external address might instead be: https://buttons-studio.example Enter an absolute URL beginning with https:// . Include the port when it is part of the address people use. The hostname in this address must be covered by the HTTPS certificate. After choosing All interfaces (0.0.0.0) , open Buttons from another machine using the configured external address. Remember that Buttons External Address tells Buttons its public URL; it does not by itself change the listen address, open a firewall port, configure DNS, or create a reverse proxy. Listening on all interfaces makes the Editor UI available to every network that can reach that port. Keep Buttons on a trusted network and do not expose the Editor port directly to the public internet. Create the first administrator A new or cleared Buttons system opens the First-time setup page. It says Create a local admin user to protect your installation. Enter the administrator username in Username . Enter a password that meets every requirement shown on the page: At least 8 characters Contains a lowercase letter Contains an uppercase letter Contains a number Contains a special character Enter the same password in Confirm password . Select Create admin user . Buttons creates the account, signs you in, and opens Home . The left navigation gives you access to areas such as Position , Connect , Workflow , Cuelist , Tags , Routing , Auth , and Settings . Some items can appear under More when the browser window is short. The first account is the system administrator. On an unlicensed system, Auth is visible but not yet interactive: user and role management need a paid license tier. Do not use this account as a shared account. Store its credentials securely, and never include real credentials in screenshots, documentation, tickets, or support messages. Use a trusted certificate The automatically generated certificate encrypts the connection, but browsers don't trust it automatically. For a permanent installation, replace it with a certificate that covers the hostname people use to open Buttons: see Replace the HTTPS certificate . If another machine cannot connect Check these three things: Environment Settings → Editor Listen Address is set to All interfaces (0.0.0.0) . The browser uses the host's real hostname or IP (not 0.0.0.0 or 127.0.0.1 ) and the configured HTTPS port. The network and host firewall allow the browser to reach that port. If the normal sign-in page appears instead of First-time setup , the system already has its first user. Sign in with an existing account or use Reset Admin Password from the watchdog on the host machine. Where to go next Read Find your way around Buttons . Add or confirm the required license . Create your first backup before building substantial configuration. Add the first connection and create an operator control .