{"id":198,"date":"2025-02-23T23:12:12","date_gmt":"2025-02-23T23:12:12","guid":{"rendered":"https:\/\/neutronxinnovation.com\/blog\/?p=198"},"modified":"2025-02-23T23:13:59","modified_gmt":"2025-02-23T23:13:59","slug":"install-ory-kratos-api-ui-with-email-setup","status":"publish","type":"post","link":"https:\/\/neutronxinnovation.com\/blog\/2025\/02\/23\/install-ory-kratos-api-ui-with-email-setup\/","title":{"rendered":"Install Ory Kratos (API & UI) with email setup"},"content":{"rendered":"

This article is in continuation to Install nginx & route traffic for different subdomains<\/a>. This post also contains some pre-configuration for Ory Kratos to be accessible on subdomain. Therefore do read it so that you don’t get confused.<\/p>\n

 <\/p>\n

In this post, we will see how we can install and Configure Ory Kratos on our server (Raspberry Pi 5 or any). This is going to be a little lengthy process. We will do it in following steps:<\/p>\n

    \n
  1. Create a schema\/database in our RDBMS (I am using MySQL) for Kratos.<\/li>\n
  2. Install and configure Kratos.<\/li>\n
  3. Create Kratos service for autostart (systemd).<\/li>\n
  4. Install and configure Kratos UI.<\/li>\n
  5. Create service for autostart (systemd).<\/li>\n
  6. Get the email service ready to send signup\/recovery emails (I am using Mailtrap.io<\/a>).<\/li>\n
  7. Test everything together!<\/li>\n<\/ol>\n

     <\/p>\n

    Let’s get started…<\/p>\n

     <\/p>\n

    Create a schema\/Database in our RDBMS for Kratos<\/h3>\n

    This was straightforward. I already had installed MySQL as mentioned here: Install Ubuntu and expose Raspberry Pi to internet<\/a><\/p>\n

    I used following SQL commands:<\/p>\n

     <\/p>\n

    create schema kratos collate utf8mb4_unicode_520_ci;\r\n\r\ncreate user kratos\r\n    identified by 'MyAmazinglySecurePassword';\r\n\r\ngrant all privileges on kratos.* to kratos;<\/pre>\n
     <\/p>\n
    Here I just created an empty schema\/database named ‘kratos’ and also a user named ‘kratos’. Last command grants all privileges on that database to kratos.<\/p>\n
     <\/p>\n
    Install and configure Kratos<\/h3>\n
    I followed the official Kratos installation guide for most steps. You can see it here if you want: Deploy to production | Ory<\/a><\/p>\n
    But I am mentioning all steps which I followed regardless, since I am writing the article \ud83d\ude1b<\/p>\n
    <\/h4>\n
    Step 1: Setup a new user for kratos in linux<\/strong><\/p>\n
    Of course we would do this so that kratos runs with it’s own user privileges. As I mentioned in Install Ubuntu and expose Raspberry Pi to internet<\/a> article, I am having all my apps in \/serverapps\/ directory. Hence I will use following directory structure to hold all auth related apps:<\/p>\n
     <\/p>\n
    \"directory<\/p>\n
     <\/p>\n
    So let’s create the directory structure:<\/p>\n
     <\/p>\n
    cd \/serverapps\r\nmkdir -p auth\/ory\r\n<\/pre>\n
     <\/p>\n
    Now let’s create a new user ‘kratos’ with disabled login and assign the owner of that directory as that user itself.<\/p>\n
    This command does it in one go:<\/p>\n
    useradd -s \/bin\/false -m -d \/serverapps\/auth\/ory\/kratos kratos<\/pre>\n
     <\/p>\n
    Step 2: Create a folder for Kratos installation\/config files<\/strong><\/p>\n
    mkdir \/serverapps\/ory\/kratos\/{bin,config}<\/pre>\n
     <\/p>\n
    Step 3: Install Ory Kratos<\/strong><\/p>\n
    This is straightforward as Kratos is simply just one executable. To see what is the latest version: Release v1.3.1 \u00b7 ory\/kratos \u00b7 GitHub<\/a><\/p>\n
    Their GitHub has a pre-built binary available for each operating system:<\/p>\n
    \"Kratos<\/p>\n
     <\/p>\n
    I have a Raspberry Pi and hence I am using Linux arm64 version.<\/p>\n
     <\/p>\n
    cd \/serverapps\/auth\/ory\/kratos\/bin\r\n\r\n# Download\r\nwget https:\/\/github.com\/ory\/kratos\/releases\/download\/v1.3.1\/kratos_1.3.1-linux_arm64.tar.gz\r\n\r\n# Extract\r\ntar xfvz kratos_1.3.1-linux_64bit.tar.gz\r\n\r\n# Remove redundant files\r\nrm kratos_1.3.1-linux_64bit.tar.gz\r\nrm *md\r\nrm LICENSE<\/pre>\n
     <\/p>\n
    Step 4: Download pre-built config files<\/strong><\/p>\n
    Now we will download pre-built config files for Kratos under config directory.<\/p>\n
     <\/p>\n
    cd ..\/config\r\n\r\nwget https:\/\/raw.githubusercontent.com\/ory\/kratos\/v1.3.1\/contrib\/quickstart\/kratos\/email-password\/identity.schema.json\r\n\r\nwget https:\/\/raw.githubusercontent.com\/ory\/kratos\/v1.3.1\/contrib\/quickstart\/kratos\/email-password\/kratos.yml<\/pre>\n
     <\/p>\n