Documentation
Advanced Settings

Advanced Settings

This guide will show you how to use the advanced settings in Jan.

Access Advanced Settings

To access Jan's advanced settings, follow the steps below:

  1. Navigate to the main dashboard.
  2. Click the Gear Icon (⚙️) on the bottom left of your screen.
  3. Under the Settings screen, click the Advanced Settings.
  4. You can configure the following settings:
FeatureDescription
Keyboard ShortcutsKeyboard shortcuts speed up your workflow. For a quick overview of useful keyboard shortcuts, refer to the list below.
Experimental ModeEnables experimental features that may be unstable.
GPU AccelerationEnables boosting your model performance by using your GPU devices for acceleration.
Jan Data FolderLocation for messages, model configurations, and user data. Changeable to a different location.
HTTPS Proxy & Ignore SSL CertificateUse a proxy server for internet connections and ignore SSL certificates for self-signed certificates. Please check out the guide on setting up your HTTPS proxy server here.
Clear LogsRemoves all logs from the Jan application.
Reset To Factory DefaultResets the application to its original state, deleting all data, including model customizations and conversation history.

Keyboard Shortcuts

Here are some of the keyboard shortcuts that you can use in Jan.

CombinationDescription
⌘ EShow list your models
⌘ KShow list navigation pages
⌘ BToggle collapsible left panel
⌘ ,Navigate to setting page
EnterSend a message
Shift + EnterInsert new line in input box
Arrow UpNavigate to the previous option (within the search dialog)
Arrow DownNavigate to the next option (within the search dialog)
The keyboard shortcuts are customizable.

Enable the Experimental Mode

To try out new features that are still in the testing phase, follow the steps below:

  1. Navigate to the main dashboard.
  2. Click the gear icon (⚙️) on the bottom left of your screen.
  3. Under the Settings screen, click the Advanced Settings.
  4. On the Experimental Mode, click the slider to enable.

Enable the GPU Acceleration

To enhance your model performance, follow the steps below:

⚠️

Ensure you have read the troubleshooting guide here for further assistance.

  1. Navigate to the main dashboard.
  2. Click the gear icon (⚙️) on the bottom left of your screen.
  3. Under the Settings screen, click the Advanced Settings.
  4. On the GPU Acceleration, click the slider to enable.

Access the Jan Data Folder

To access the folder where messages, model configurations, and user data are stored, follow the steps below:

  1. Navigate to the main dashboard.
  2. Click the gear icon (⚙️) on the bottom left of your screen.
  3. Under the Settings screen, click the Advanced Settings.
  4. On the Jan Data Folder click the folder icon (📂) to access the data or the pencil icon (✏️) to change the folder where you keep your data.

HTTPS Proxy

HTTPS Proxy encrypts data between your browser and the internet, making it hard for outsiders to intercept or read. It also helps you maintain your privacy and security while bypassing regional restrictions on the internet.

  • When configuring Jan using an HTTPS proxy, the speed of the downloading model may be affected by the encryption and decryption process. It also depends on the cloud service provider's networking.

  • HTTPS Proxy does not affect the remote model usage.

Setting Up Your Own HTTPS Proxy Server

This guide provides a simple overview of setting up an HTTPS proxy server using Squid, a widely used open-source proxy software.

Other software options are also available depending on your requirements.

Step 1: Choosing a Server

  1. First, you must choose a server to host your proxy server.

We recommend using a well-known cloud provider service like:

  • Amazon AWS
  • Google Cloud
  • Microsoft Azure
  • Digital Ocean
  1. Ensure your server has a public IP address and is accessible from the internet.

Step 2: Installing Squid

Instal Squid using the following command:


sudo apt-get update
sudo apt-get install squid

Step 3: Configure Squid for HTTPS

To enable HTTPS, you will need to configure Squid with SSL support.

  1. Squid requires an SSL certificate to handle HTTPS traffic. You can generate a self-signed certificate or obtain one from a Certificate Authority (CA). For a self-signed certificate, you can use OpenSSL:

openssl req -new -newkey rsa:2048 -days 365 -nodes -x509 -keyout squid-proxy.pem -out squid-proxy.pem

  1. Edit the Squid configuration file /etc/squid/squid.conf to include the path to your SSL certificate and enable the HTTPS port:

http_port 3128 ssl-bump cert=/path/to/your/squid-proxy.pem
ssl_bump server-first all
ssl_bump bump all

  1. To intercept HTTPS traffic, Squid uses SSL Bumping. This process allows Squid to decrypt and re-encrypt HTTPS traffic. To enable SSL Bumping, ensure the ssl_bump directives are configured correctly in your squid.conf file.

Step 4 (Optional): Configure ACLs and Authentication

  1. You can define rules to control who can access your proxy. This is done by editing the squid.conf file and defining ACLs:

acl allowed_ips src "/etc/squid/allowed_ips.txt"
http_access allow allowed_ips

  1. If you want to add an authentication layer, Squid supports several authentication schemes. The basic authentication setup might look like this:

auth_param basic program /usr/lib/squid/basic_ncsa_auth /etc/squid/passwords
acl authenticated proxy_auth REQUIRED
http_access allow authenticated

Step 5: Restart and Test Your Proxy

  1. After configuring, restart Squid to apply the changes:

sudo systemctl restart squid

  1. To test, configure your browser or another client to use the proxy server with its IP address and port (default is 3128).
  2. Check if you can access the internet through your proxy.

Tips for Secure Your Proxy:

  • Firewall rules: Ensure only intended users or IP addresses can connect to your proxy server. This can be achieved by setting up appropriate firewall rules.
  • Regular updates: Keep your server and proxy software updated to protect you against known vulnerabilities.
  • Monitoring and logging: Monitor your proxy server for unusual activity and enable logging to keep track of the traffic passing through your proxy.

Step 6: Enable the HTTPS Proxy

Once you set up your HTTPS proxy server, you can configure it for Jan.

  1. Navigate to Settings > Advanced Settings.
  2. On the HTTPS Proxy, click the slider to enable.
  3. Input your domain in the blank field.

Ignore SSL Certificate

To Allow self-signed or unverified certificates, follow the steps below:

  1. Navigate to the main dashboard.
  2. Click the gear icon (⚙️) on the bottom left of your screen.
  3. Under the Settings screen, click the Advanced Settings.
  4. On the Ignore SSL Certificates, click the slider to enable.

Clear Logs

To clear all logs on your Jan app, follow the steps below:

⚠️

This feature clears all the data in your Jan Data Folder.

  1. Navigate to the main dashboard.
  2. Click the gear icon (⚙️) on the bottom left of your screen.
  3. Under the Settings screen, click the Advanced Settings.
  4. On the Clear Logs click the the Clear button.

Reset To Factory Default

To reset the Jan app to its original state, follow the steps below:

🚫

This irreversible action is only recommended if the application is corrupted.

  1. Navigate to the main dashboard.
  2. Click the gear icon (⚙️) on the bottom left of your screen.
  3. Under the Settings screen, click the Advanced Settings.
  4. On the Reset To Factory Default click the the Reset button.