Thanks for checking out the documentation of our JustJobs product. Here you'll find about everything you need in order to get started with launching your app.

If you are not familiar with the terms or the techstack or if you don't have the time to install and configure the application, we cand handle the installation services for an additional fee.

Before proceeding with the install, please make sure your instance meets the following criteria.

1. Nginx requires a vhost similar to the default laravel one.
2. The script can ran on pretty much everything, but for hosting, we usually recommend DigitalOcean servers.
3. If having less tech experience, we strongly recommend using a panel-based server. EG: cPanel/Cyberpanel.

Files Setup

Before proceeding with the installation, you need to extract the script contents onto the directory that will serve your domain. This can be done via cPanel’s File Manager, FTP, or command line.

Upload and extract the archive

• 1. If you’re using cPanel, navigate to File Manager and upload your .zip file containing the script.
• 2. Once uploaded, right-click and choose Extract to unpack all contents.
• 3. Copy the contents of the Script folder onto the public_html directory of the domain your are about to use.
• 4. Make sure you also copy any hidden files (e.g., .env, .htaccess).

Configure file permissions

In order for the script to work properly, set the following folders to CHMOD 755: vendor, storage, bootstrap .

Changing the public directory Important

Configure your web server’s document root to point to the public directory of the software. For example, if you uploaded the code into example.com, update the doc root to example.com/public.

If your hosting provider doesn’t allow changing your DocumentRoot, you can temporarily rename .htaccess.sample to .htaccess. Use this only as a temporary solution.

Database Setup

You need a MySQL or MariaDB database ready for the script. If using cPanel, go to MySQL Databases or the MySQL Database Wizard to create a new database and user.

• Create a new database (e.g., myapp_db).
• Create a new user (e.g., myapp_user) with a secure password.
• Assign the user to the database, ensuring it has ALL PRIVILEGES or the privileges required by your script.

Once done, you should have the following info:

• Database Name (e.g., myapp_db)
• Database Username (e.g., myapp_user)
• Database Password (e.g., 123456)
• Database Host (often localhost)

Installer

After preparing your files and database, run the web-based installer by visiting https://your-domain.com/install. This panel will guide you through a simple, 3-step process:

1. Requirements Check: The installer verifies if your server meets the minimum requirements (PHP version, extensions, etc.). If something is missing, you’ll need to fix it before proceeding.
2. Database Setup: Provide the DB name, user, password, and host you created above.
3. Site & Admin Settings: Configure your site’s name, admin login credentials, and license details.

Once you finish, the installer will set up your database tables, and you’ll be ready to log in to your admin panel to customize additional aspects of the platform.

If the web-installer is not available at https://your-domain.com/install, check out the https://your-domain.com/public/install one as well. If that one functions, it means you're DocumentRoot isn't properly set.

Payments system

To receive payments, you need to set up at least one payment provider. Go to Admin > Settings > Payments to configure your chosen provider(s). You’ll also find webhook endpoints in that section for each processor.

Below are instructions for each supported gateway. Follow the relevant steps for the provider(s) you plan to use.

# Stripe

• Log in to your Stripe Dashboard.
• From the sidebar, go to Developers > API Keys.
• Copy the Publishable key and Secret key and paste them into Admin > Settings > Payments > Processors > Stripe.
• Next, open Webhooks and click Add endpoint.
• For the Endpoint URL, use the webhook endpoint from Admin > Settings > Payments > Processors > Stripe.
• Select the Version (latest) and choose Select all events under events to listen to.
• Once created, Stripe provides a Webhook secret. Copy that into Admin > Settings > Payments > Stripe Webhooks Secret.

# PayPal

• Log in via the PayPal Developer Dashboard .
• Go to My apps & credentials , set Live, and click Create App to make a new PayPal app.
• Copy the ClientID & Secret Key and add them into Settings > Payments in your admin panel.
• Back in the PayPal dashboard, select your newly created app (under Live).
• Scroll down to Production Webhooks and click Add Webhook.
• For Webhook URL, use the endpoint from Admin > Settings > Payments.
• Under Event types, select All Events and click Save.

# Coinbase

• Log in to Coinbase Commerce.
• Go to the Settings section.
• Under API keys, click Create an API key and copy it. Paste it into Settings > Payments in your admin panel.
• For Webhook subscriptions, click Add an endpoint. The webhook URL is in Admin > Settings > Payments.
• Click Show shared secret and add it into the admin panel as well.

# NowPayments

• Log in at NowPayments.
• Go to Store settings and add a new API Key.
• Copy the key and paste it into Settings > Payments as NowPayments Api Key.
• Generate an IPN secret key there and add it into Admin > Settings > Payments > NowPayments IPN Secret Key.
• Add crypto wallets in your NowPayments account. We recommend adding many to lower conversion rates.
• We recommend setting a payment covering percentage so that slightly underpaid transactions can still count as completed. Example: If set to 5%, a $100 invoice will be treated as paid in full if $95 is received.

# CCBill

• Log in via CCBill sign in.
• Go to FlexForms Systems and note your Flex ID.
• Add the FlexForm Id in Settings > Payments > Payment Processors > CCBill.
• Add your CCBill Account Number in admin settings.
• Go to Account Info > Sub Account Admin, under Basic to set your approval & denial URLs (from Admin > Settings > Payments).
• In Webhooks, add your admin CCBill Webhook URL (format: JSON).
• For recurring payments, repeat steps for your recurring sub account.
• Request your Salt key from CCBill and fill it in the admin panel.
• To automatically cancel subscriptions, set up a DataLink API user:
  • In your CCBill recurring sub account, go to Account info > DataLink Services Suite.
  • Click Add user, fill in a username and password, enable Subsystem checkboxes, and add your server IP to Valid Ips.
  • Click Store user and add these credentials in Settings > Payments > Payment processors > CCBill as CCBill DataLink Username / Password.

# Paystack

• Log in at Paystack dashboard .
• Go to Settings > Developer .
• Under API Keys & Webhooks, copy the Secret key and paste it into Settings > Payments > Payment processors > Paystack.
• Copy your Webhook & Callback URLs from the admin panel and add them to Paystack’s Settings > Developer as well.

Cron Setup

In order for the platform to function fully, including payment processing, emails, offers, and more, you need to set up the following cron job.

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1 

Some hosting panels might require the cron command in a different format. If needed, you can run it with absolute paths or specific PHP versions:

* * * * * php /path-to-your-project/artisan schedule:run >> /dev/null 2>&1

Other hosting panels with have you set the task interval out of their own UI, so you might end up using a command that doesn't include the * * * * * prefix.

Ensure Cron Jobs Are Running

Cron jobs are crucial for payments, emails, and other scheduled tasks.

• Ensure they’re not returning any errors by manually running cd /path-to-your-project && php artisan schedule:run via CLI.
• Check that storage/logs/cronjobs.log exists within 24h since the task has been setup.

Emails

You can choose among three main email drivers—Mailgun (via API), SMTP, or PHP’s mail() function, if available. There’s also a logging driver option for debugging.

All email-related settings are located under Admin > Settings > Emails. Below is a quick summary:

1. Mail from name: The display name used when sending emails.
2. Mail from address: The sending address (e.g., no-reply@domain.com).

# Log Driver

The Log driver is mostly used for debugging. Any outgoing emails are recorded in storage/logs/laravel.log instead of being sent.

# Sendmail Driver

This driver relies on the PHP mail() function being active. Many cPanel-based shared hosting providers enable it by default.

# Mailgun Driver

Mailgun is an API-based service. To use it, you’ll need:

1. Mailgun domain – The custom domain/subdomain you set up on Mailgun, along with valid DNS records.
2. Mailgun secret – Domain API key
3. Mailgun endpoint – Typically api.mailgun.net for US or api.eu.mailgun.net for EU.

# SMTP Driver

Using SMTP requires the following:

1. SMTP Host – e.g., your mail server’s hostname or IP
2. SMTP Port – 587 (TLS) or 465 (SSL), depending on provider
3. SMTP Encryption – TLS or SSL
4. SMTP Username
5. SMTP Password

You can use wide range of storage providers for storing your user-uploaded files, improving site I/O load, response time and security.

# Amazon's S3

You can use our AWS S3 (including CloudFront and CloudFront Signed URLs) implementation for faster and more secure delivery via pre-signed urls.

S3 Storage

To upload your data to Amazon S3, you must first create an S3 bucket in one of the AWS regions:

1. Go to AWS Console and log in or create an account.
2. After logging in, use Search for services and look for S3.
3. On the S3 page, click Buckets > Create bucket.
4. Specify your bucket name and region.
5. Enable Make public using ACL.
6. Disable Block all public access.
7. Enable I acknowledge that the current settings might result in this bucket and the objects within becoming public.
8. Keep other settings at defaults, then click Create bucket.
9. After successfully creating the bucket, go back to Search for services and look for IAM (Identity and Access Management) to generate access keys.
10. Go to Access management > Users and click Add users.
11. Set a username and enable Provide user access to the AWS Management Console - optional.
12. Under Set permissions, choose Attach policies directly and search for AmazonS3FullAccess (or create a custom policy). Click Next.
13. Review, optionally add tags, then click Create user.
14. Once created, click the username to view details.
15. Under Security credentials, click Create access key.
16. In the Create access key dialog, choose the option that fits your needs, and click Create access key.
17. Note the AWS Access Key ID and Secret access key—you won’t be able to view the secret again after closing the dialog.
18. In your admin panel (Admin > Settings > Storage), add the bucket name, AWS Access Key ID, and AWS Secret access key.

S3 + CloudFront

Use CloudFront to distribute your content globally by creating a CloudFront distribution:

1. Complete the S3 steps above to have a public bucket ready.
2. Search for CloudFront in AWS and click Distributions > Create distribution.
3. Under Origin > Origin Domain, select your S3 bucket.
4. Most defaults are fine unless you need custom settings.
5. After creating the distribution, copy the Distribution domain name (e.g., abc123.cloudfront.net), then go to Admin > Settings > Storage, add it to Aws CloudFront Domain Name, and enable CloudFront.
6. For more details, see Steps for Creating a Distribution .

S3 + CloudFront + Signed URLs

To use signed URLs, you need a signer (a trusted key group) in CloudFront.

1. Create a key pair (e.g., via OpenSSL):
   The steps below use OpenSSL as an example. There are other methods as well.
   • openssl genrsa -out private_key.pem 2048
   • openssl rsa -pubout -in private_key.pem -out public_key.pem
2. Upload the public key to CloudFront:
   • Log into CloudFront console .
   • Navigate to Key management > Public keys > Create public key.
   • Give it a Name, then paste the contents of public_key.pem in the Key field.
   • Copy the Public Key ID after adding. This is your Key-Pair-Id (and corresponds to Aws CloudFront Key Pair Id in the admin panel).
3. Add the public key to a key group:
   • Go to Key management > Key groups > Create key group.
   • Name the group, select the public key, and click Add.
   • Click Create key group.
4. Add a signer to your distribution:
   • Open your CloudFront distribution and select the Behaviors tab.
   • Edit the behavior for the path you want to protect.
   • Under Restrict Viewer Access, choose Yes.
   • Under Trusted Key Groups, select the group you just created.
   • Save changes.
5. Add your Key-Pair-Id and the path to your private_key.pem into Admin > Settings > Storage, then enable CloudFront Signed URLs.
6. Make sure your S3 bucket permissions are set to public.
7. For more details, see Serving private content with signed URLs .

# Wasabi

If you prefer using Wasabi, change the driver in Admin > Settings > Storage > Driver. Then add your Wasabi credentials (found on their website).

You must also add the following policy to your Wasabi bucket:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowPublicRead",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::your-bucket-name/*"
    }
  ]
}

# DigitalOcean Spaces

If you want to use DigitalOcean Spaces, select it under Admin > Settings > Storage > Driver. Then follow these steps:

1. Create a new Spaces access key and save the key/secret.
2. In Admin > Settings > Storage, add your new DO Access Key and DO Secret Key.
3. Go to Spaces and create a new space. Defaults should be fine.
4. Once created, you’ll see a URL like https://{bucket-name}.{region}.digitaloceanspaces.com.
5. For DO Bucket, use {bucket-name}, and for DO Region, use {region}.

# Minio

If you have a self-hosted Minio instance, you can switch the driver to Minio in Admin > Settings > Storage > Driver. Then:

1. Create a new set of keys in Minio and copy them.
2. In Admin > Settings > Storage, fill in Minio Access Key and Minio Secret Key.
3. Create a new bucket and set it in Admin > Settings > Storage > Minio bucket.
4. For Minio Region, specify the region your instance uses.
5. For Minio Endpoint, specify your Minio server endpoint.

# PushrCDN

If you have a PushrCDN account, you can switch the driver to PushrCDN under Admin > Settings > Storage > Driver. Then:

1. Go to the CDN page and create a Push zone.
2. Set a label and for Sonic Storage Type, choose AWS S3-compatible.
3. Open Storage and Hostnames, then fill in your keys, bucketname, S3 endpoint, and CDN Hostname.

Captcha

To protect your public forms (e.g., registration, contact, etc.) from spam, you can choose one of the following drivers under Admin > Settings > Security > Captcha:

• Google reCAPTCHA
• Cloudflare Turnstile
• hCaptcha

Each driver typically requires a site key and a secret key. Once these are added, your chosen captcha will be enforced on the designated public forms.

# Google reCAPTCHA

Google’s reCAPTCHA is a popular solution for verifying that form submissions are from real users.

• Go to Google reCAPTCHA Admin to create a new app.
• Choose reCAPTCHA v2 > "I'm not a robot" Checkbox (or whichever suits your needs).
• Copy the provided Site Key and Secret Key.
• In your admin panel, navigate to Admin > Settings > Security > Captcha.
• Select Google reCAPTCHA as the Captcha Driver, then paste your Site Key and Secret Key in the fields provided.

# Cloudflare Turnstile

Cloudflare Turnstile is a user-friendly, privacy-focused captcha alternative.

• Log into Cloudflare Dashboard and create or open your project.
• Go to the Turnstile section to create a new site, then copy the Site Key and Secret Key.
• In Admin > Settings > Security > Captcha, select Turnstile as the Captcha Driver and paste your keys.

# hCaptcha

hCaptcha is another popular captcha solution focused on privacy and security. To set it up:

• Go to hCaptcha’s official site or dashboard and create your account.
• Once your project is created, copy the Site Key and Secret Key.
• In Admin > Settings > Security > Captcha, select hCaptcha as the Captcha Driver.
• Paste your hCaptcha Site Key and Secret Key into the respective fields.

Social logins

Though each social login provider’s interface may differ, the general steps to enable social logins are:

• Obtain an approved app on the social login provider.
• Copy your Client ID and Client Secret keys.
• Add these keys to Admin > Settings > Social media in your admin panel.
• In Admin > Settings > Social media, copy the Callback URL for each provider.
• Paste this Callback URL into the provider’s settings (e.g., “Authorized redirect URIs” or “Callback URLs” field).

# Twitter

• Go to https://developer.twitter.com and create a new app.
• Get elevated access to the Twitter API via this link .
• Choose your Application Environment (dev or prod), name your app, and you’ll receive an API Key and API Key secret. Add them to Admin > Settings > Social media.
• Once created, go to app settings > “User authentication settings” > Setup.
• For “App permissions,” select “Read,” and also enable “Request email address from users,” if desired.
• Copy the Callback URL from your admin panel and add it to the “Callback URLs” field in your Twitter app’s settings.

# Google

• Create a new project at https://console.developers.google.com/projectcreate .
• Generate credentials at https://console.developers.google.com/apis/credentials .
• Choose “OAuth client ID > Consent > Web application.”
• Copy your Client ID and Client Secret, then add them to Admin > Settings > Social media.
• Copy the Callback URL from your admin panel and add it to your Google “Authorized redirect URIs.”

# Facebook

• Visit https://developers.facebook.com/apps and create a new app (Consumer). Fill in any required details.
• Go to App settings > Basic, copy the App ID & App secret, and add them to Admin > Settings > Social media.
• Navigate to App > Facebook Login > Settings.
• Copy the admin Callback URL and add it under Valid OAuth Redirect URIs in your Facebook app settings.

OpenAI

The AI-suggestions feature allows users to get smart text suggestions (for posts, bios, or other areas) from OpenAI’s language models. This can save time and help with writer’s block by automatically generating text ideas.

Important: OpenAI’s API is usage-based, meaning costs can accrue if you or your users make many requests. Be sure to monitor your usage in your OpenAI account to avoid unexpected charges.

To configure AI suggestions in this platform:

1. Go to Admin > Settings > AI and enable the “AI suggestions” feature.
2. Create or log in to your account at https://platform.openai.com .
3. In your OpenAI dashboard, find the “API Keys” section. Create a new secret key and copy it. (You won’t be able to see it again later.)
4. Back in the admin panel, under Admin > Settings > AI, paste your new OpenAI API Key into the field provided. Click “Save” to update.

Once configured, users can click a button (or similar UI element) to get text suggestions in your app’s relevant areas. If you see any errors, confirm that your API key is valid and that your OpenAI account has sufficient credits.

Slack

Enabling slack webhook notifications, your slack channel will get updated with new job postings, for the plans that allows slack promotions.

• Sign in to your Slack workspace.
• Go to Slack API: Apps and click Create New App.
• Select From scratch, name your app, and choose your workspace.
• In the left sidebar of your new app’s settings, choose Incoming Webhooks.
• Enable the toggle to turn on Incoming Webhooks.
• Click Add New Webhook to Workspace.
• Select the channel where messages should post, then click Allow.
• Copy the generated webhook URL.
• In Admin > Settings > Slack, paste the copied URL into the Slack webhook URL field.

Localization

To translate your site into another language, make a copy of the default en.json file found in the lang folder and modify it as needed.

• The JSON language file must use an ISO code, e.g. es.json, ro.json, or en.json.
• If you need to overwrite validation messages or other library strings, copy the en folder (and its files) and rename it to your new language code.

If everything went fine, you can access the Admin panel at http://your-domain.com/admin. The initial admin credentials were set during installation/user creation.

After setting up your main admin account, you can manage roles and create other admin users within the admin panel.

If you lose access to your admin account, you can reset the user password or create another user with admin privileges via the following command or SQL query:

• php artisan voyager:admin user@example.com
• UPDATE users SET role_id = 1 WHERE email = 'user@example.com'

Using the admin panel, you can now continue with setting up the rest of settings for your instance, like branding elements, colors, taxes and more.

Whenever new major updates are available, you will be notified via Envato. When notified, head over your Envato Downloads area and download the latest .zip archive. Once downloaded, you can proceed with:

1. Make a backup of the .env config file located on your server.
2. Upload the .zip, onto your server and extract it.
3. Copy over (overwrite) the contents of Script folder into your website folder.
4. Restore your .env config file on your server.
5. Go to https://example.com/update and follow the update wizard.¹

• I have a support inquiry, a question or a problem, how can I contact you?
  You can contact us by sending us a private message over our Codecanyon profile .
• What hosting do you recommend?
  We recommend using DigitalOcean , as they offer great performance and flexibility at an affordable price.
• Is installation included in the price?
  No, installation is not included. We offer installation services for an extra fee, for which you can send us a message.
• My website returns a Not Found message, why?
  Please ensure that you have mod_rewrite enabled on your server.
• # I have uploaded my files but get a 500 error. Why?
  This usually happens due to a couple of reasons:

  • When uploading the script files via FTP, and your operating system is skipping hidden files, including .env. Re-upload that file, plus any other hidden files (like .htaccess), or upload the entire .zip onto the server and extract it there
  • It can also happen when moving files around in cPanel's File Manager. Make sure to go to Settings > Preferences and check Show hidden Files (dotfiles) so that hidden files are selectable.
  • Another cause could be a missing PHP extension. Check storage/logs/laravel.log for the exact error or missing extension.

• # How can I edit my homepage?

  Generally, each page—including the homepage—has the following structure:

  1. Controllers are located in the app/Http/Controllers folder.
  2. Views (the HTML) are located resources/views/page.blade.php path.
  3. Javascript code is located at public/js/pages/page.js path.
  4. CSS code is located at public/css/pages/page.css path.

  So, for the homepage specifically, you might find files like home.css, home.js, home.blade.php, etc. You’ll need to back up and replace any of the modified files after each update

  You can handle most of the branding elements out of the admin, as for the text/strings, you can simply change them out of the translation files.

• # How can I update my custom modified version of the script?

  We recommend the following workflow for maintaining custom versions:

  1. Create your own private repository. Not using a private will get the repo auto-taken down.
  2. Host your custom code changes on a separate branch.
  3. Pull or merge new updates from the main branch.
  4. Resolve any conflicts if necessary.
  5. Release your (custom) updated version of the script.
  6. Use the How to update guide for applying final changes.

• # How can I change the PWA app icons?

  To change your PWA app icon and splash screen assets, replace the existing icons within public/img/pwa.

  After replacing them, clear your browser cache to see the updated icon and splash screen.

• Assets are not uploading or displaying when using local storage. Why?
  First, check whether Admin > Settings > Site url has an invalid value. Next, confirm the storage symlink is active. If not, re-create it by:

  1. rm -rf public/storage
  2. ln -s storage/app/public public/storage
• # I’m getting a 500 error after changing the file storage driver. Why?
  This typically happens if the storage driver credentials are incorrect. If you can’t access the admin panel, reset the driver via a DB query: UPDATE settings SET value='public' WHERE id=95;
• # I am having issues with uploading large files. What can I do?
  This is usually related to server/web-server/PHP limits. You can tweak:
  • Admin > Settings > Media > Max file uploads size
  • Admin > Settings > Media > Chunked uploads
  If you still have issues, these PHP settings might help, but other firewall or server configurations can also affect uploads.
• # I'm having issues with ffmpeg-encoded videos. Why?
  This often stems from the server/web-server or the FFMpeg build. Possible causes range from missing encoders to memory errors. The storage/logs/laravel.log file usually shows the actual error.
  If it's audio-encoder or memory-related, try adjusting:
  • Admin > Settings > Media > FFMpeg video conversion quality preset
  • Admin > Settings > Media > FFMPEG Audio encoder
  If problems persist, you may need to reconfigure server settings or upgrade the FFMpeg build.
• # How do I test payments on the demo website?
  Depending on your chosen payment provider, these test credentials can be used:

  • Stripe:
    Card: 4242 4242 4242 4242
    Date: Any future date
    CVC: 123
  • PayPal:
    Email: sb-mzdi86428457@business.example.com
    Password: Dz1d_EP/
  • CCBill:
    VISA: 4111111111111111
    MasterCard: 5105105105105100
    Discover: 6011111111111117
    CVV: 300