Installation and first login

Install Process GPT Lite on one PC with Docker using a single command, add your LLM key, and log in for the first time with a code sent by email. Once you finish the first-run guide that follows login (date of birth → greeting → mail connection), you're ready for the hands-on work from Chapter 2.

What gets installed#

Process GPT Lite is made of the screen (web app) and the Process GPT backend that works behind it. The install script downloads and builds all of this as Docker containers, prepares the database, and even creates the first administrator account.

Everything runs inside your PC. The only things that go outside are LLM calls (to the API address you set) and, once connected, mail and external services.

What you need#

You can install on macOS, Linux and Windows (WSL2). On Windows, we recommend installing Docker Engine inside WSL2.

Install#

Run one line in a terminal. It downloads the repository to ~/process-gpt-lite and runs the install script.

curl -fsSL https://raw.githubusercontent.com/uengine-oss/process-gpt-lite/main/install/get.sh | bash

Cloning the repository yourself works the same way.

git clone https://github.com/uengine-oss/process-gpt-lite.git
cd process-gpt-lite/install
./install.sh

The script asks a few questions. The value in brackets is the default. Just press Enter to use it.

The first time, building the images takes 20–40 minutes (the IeumOffice editor takes the longest). When it's done, you see a summary like this.

  Process GPT Lite is ready

    Address      http://localhost:18080
    Admin        admin@pgpt-lite.local
    Login code   Enter your email and the code goes to the mailbox → http://localhost:18025

Profiles — how much to run#

The settings file .env#

.env in the install folder (install/) holds all the settings. It's created on the first run, with 0600 permissions so only you can read it. Secret values such as the database password, the login token signing key and the Vault master key are generated at random and filled in by the script. They're never printed on screen or in logs, and they're kept as they are when you upgrade.

These are the values you'll change most often.

After editing .env, run ./install.sh again and the containers restart with the new values. Your data stays as it is.

Ports and addresses#

By default, the app opens only on this PC (127.0.0.1). If another program is using 18080, change it like ./install.sh --port 28080. To let teammates connect from other PCs, change .env to PUBLIC_URL=http://<this PC's IP>:18080 and LITE_BIND=0.0.0.0, set up SMTP, and run ./install.sh again. You need SMTP because the bundled mailbox opens only on this PC. When you open the app to the internet, put an HTTPS reverse proxy in front of it.

First login#

Open http://localhost:18080 in a browser. Over the sky picture on the left, an example sentence such as "Draft a reply to the Northwind quote request email using last year's terms" types itself out one letter at a time. It's an example of what you can ask this app to do.

1. Enter your email address and click Continue. Try logging in first with the administrator email you entered during installation.
2. Open the bundled mailbox http://localhost:18025. An email with a 6-digit code is waiting. If you set up SMTP, it goes to your real mailbox.
3. Enter the code in the six boxes and you're logged in right away. Pasting works too.

If you put GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in .env, you can also log in with Continue with Google. If you didn't, this button tells you "Please continue with email."

Just once — the first-run guide#

The first time you log in, three screens appear in turn. They appear only once. After that, the chat screen opens directly.

① Name and date of birth. If you logged in with an email code, it first asks for your name: "What should I call you?" This name appears in the teammate list and in greetings, so enter your real name (in this tutorial, Jinyoung Jang). If you logged in with Google and your name is already known, this field doesn't appear. Your date of birth is asked so the service fits your age, and it isn't shown to anyone else. Choose the year, month and day, then click Continue.

② Greeting. The sentence "process gpt, think of me as your own operating system for work." types itself out, and then the chat screen opens on its own.

③ The assistant introduces itself and offers to connect mail. In the chat, the assistant introduces itself in three sentences and suggests connecting your mail. On a server with Google login set up, the button reads Sign in with Google. Otherwise it reads Connect mail.

Click the button and a window opens where you choose how to connect. In this tutorial, choose Demo mailbox. It's a practice mailbox with five fictional client emails, so you can follow the next chapters as written without connecting real mail. You'll get more mail for the exercises later with Get practice email (Chapter 5). Gmail and IMAP connections are covered in detail in Chapter 5.

About a minute after you connect, the assistant reads your mail, leaves a Morning brief in the chat (an Afternoon or Evening brief later in the day), and puts four to-do cards on Home.

Stop, upgrade, remove#

If something goes wrong#

Next#

Installation and first login are done. In the next chapter, you take a tour of the screen you just opened — Home cards, Chat, the top bar and Settings (Chapter 2).