Cara Hosting Source Code POS Kasir Codekop ke cPanel hingga Online
poskasir hosting shared hosting php pos kasir codekop
🚀 Tutorial Hosting

Cara Hosting Source Code POS Kasir Codekop ke cPanel hingga Online

Source Code POS Kasir Codekop tidak hanya dapat dijalankan di komputer menggunakan XAMPP. Aplikasi juga dapat dipasang pada hosting berbasis cPanel agar dapat diakses secara online.

Dengan memasang aplikasi POS Kasir di hosting, pemilik usaha dapat mengakses data penjualan melalui komputer, laptop, tablet, maupun smartphone selama terhubung ke internet.

📦 Persiapan Sebelum Instalasi

Sebelum memulai proses instalasi, siapkan beberapa kebutuhan berikut:

✅ Hosting yang memiliki akses cPanel.
✅ Domain atau subdomain yang sudah terhubung ke hosting.
✅ File Source Code POS Kasir Codekop.
✅ File database dengan format .sql.
✅ Username dan password akun cPanel.
✅ Hosting yang mendukung PHP dan MySQL atau MariaDB.
⚠️ Pastikan source code sudah dapat berjalan dengan baik di localhost sebelum dipindahkan ke hosting.

🔐 1. Login ke cPanel Hosting

Buka halaman login cPanel yang diberikan oleh penyedia hosting Anda. Masukkan username dan password, kemudian klik tombol Log In.

Setelah berhasil masuk, biasanya tersedia beberapa menu berikut:

📁 File Manager
🌐 Domains
🗄️ Database Wizard
📊 phpMyAdmin
🐘 MultiPHP Manager
🔒 SSL/TLS Status

Nama dan posisi menu dapat berbeda tergantung tema serta konfigurasi penyedia hosting.

🌐 2. Tentukan Domain atau Subdomain Aplikasi

Aplikasi POS Kasir dapat dipasang pada domain utama, subdomain, maupun folder tertentu.

Jenis Instalasi Contoh Alamat
Domain utama https://tokosaya.com
Subdomain https://kasir.tokosaya.com
Folder https://tokosaya.com/kasir
✅ Untuk penggunaan sebagai aplikasi internal toko, subdomain seperti kasir.tokosaya.com biasanya lebih rapi dan mudah diingat.

Jika ingin menggunakan subdomain, buka menu Domains, kemudian buat domain atau subdomain baru sesuai kebutuhan.

Perhatikan bagian Document Root karena folder tersebut menjadi lokasi aplikasi.

/public_html/kasir

Atau pada beberapa hosting dapat menggunakan folder seperti berikut:

/kasir.tokosaya.com

🗜️ 3. Kompres Source Code Menjadi ZIP

Sebelum diunggah ke hosting, kompres seluruh file Source Code POS Kasir menjadi satu file ZIP.

Contoh nama file:

pos_kasir.zip
❌ Hindari struktur folder bertingkat karena dapat menyebabkan aplikasi tidak ditemukan saat domain dibuka.

Contoh struktur yang kurang tepat:

pos_kasir/
    index.php

Struktur yang benar setelah file diekstrak sebaiknya langsung seperti berikut:

public_html/
index.php
setting.php
login.php
logout.php
boostrap.php
404.php
.htaccess
assets/
database_sql/
layouts/
vendor/
views/

Nama folder dan file dapat berbeda tergantung versi POS Kasir Codekop yang digunakan.

📤 4. Upload Source Code melalui File Manager

Buka menu berikut di cPanel:

cPanel → Files → File Manager

Masuk ke folder document root domain atau subdomain yang telah dibuat.

Untuk domain utama biasanya menggunakan folder:

public_html

Langkah upload source code:

  1. Klik tombol Upload.
  2. Pilih file pos_kasir.zip.
  3. Tunggu proses upload sampai selesai.
  4. Kembali ke halaman File Manager.
  5. Klik kanan file ZIP.
  6. Pilih menu Extract.
  7. Pastikan lokasi extract sudah benar.
  8. Klik tombol Extract Files.

Pastikan file index.php berada langsung di dalam document root.

✅ Struktur benar: 
/public_html/kasir/index.php
❌ Struktur kurang tepat: 
/public_html/kasir/pos_kasir/index.php

Jika masih terdapat folder tambahan, pindahkan seluruh isi folder tersebut ke document root aplikasi.

🗄️ 5. Membuat Database MySQL

Buka menu berikut:

cPanel → Databases → Database Wizard

Pada beberapa versi cPanel, menu tersebut dapat bernama MySQL Database Wizard.

Membuat nama database

Masukkan nama database, misalnya:

poskasir

cPanel biasanya menambahkan username akun hosting di bagian depan nama database.

Contoh nama database lengkap:

usernamecpanel_poskasir

Membuat username database

Masukkan username database, misalnya:

posuser

Contoh hasil username database lengkap:

usernamecpanel_posuser

Membuat password database

Gunakan password yang kuat dengan kombinasi berikut:

  • 🔠 Huruf besar
  • 🔡 Huruf kecil
  • 🔢 Angka
  • 🔣 Simbol
📝 Catat nama database, username database, dan password karena akan digunakan pada file konfigurasi aplikasi.

Memberikan hak akses database

Pada bagian privileges, pilih:

ALL PRIVILEGES

Lanjutkan proses sampai muncul pemberitahuan bahwa database dan user berhasil dibuat.

📥 6. Import File Database SQL

Setelah database berhasil dibuat, buka menu:

cPanel → Databases → phpMyAdmin

Langkah import database:

  1. Pilih nama database pada bagian kiri.
  2. Klik menu Import.
  3. Klik tombol Choose File.
  4. Pilih file database dengan ekstensi .sql.
  5. Pastikan format yang dipilih adalah SQL.
  6. Klik tombol Import atau Go.
  7. Tunggu proses import sampai selesai.

Jika berhasil, tabel aplikasi akan tampil di dalam database.

Contoh tabel yang mungkin tersedia:

users
barang
kategori
penjualan
penjualan_detail
dsb...

ℹ️ Nama tabel dapat berbeda tergantung versi aplikasi POS Kasir Codekop.

Jika file SQL terlalu besar

  • 📦 Kompres file SQL menjadi format ZIP.
  • ⬆️ Naikkan nilai upload_max_filesize.
  • ⬆️ Naikkan nilai post_max_size.
  • ☎️ Hubungi penyedia hosting.
  • ⌨️ Gunakan SSH jika tersedia pada paket hosting.

🔌 7. Mengatur Koneksi Database

Buka kembali File Manager, kemudian cari file konfigurasi database aplikasi.

Nama file konfigurasi dapat berbeda, misalnya:

setting.php

Buka file tersebut menggunakan menu Edit, kemudian sesuaikan nama database, username, dan password.

Contoh koneksi database menggunakan PDO

<?php
/*
|--------------------------------------------------------------------------
| Connect DB PHP MySQL
|--------------------------------------------------------------------------
|
*/
    $host     = "localhost";
    $user     = "root";
    $pass     = "";
    $dbname   = "codekop_pos_kasir";

    $connectdb = new PDO("mysql:host=$host;dbname=$dbname", $user, $pass);
/*
|--------------------------------------------------------------------------
| Project Title Name
|--------------------------------------------------------------------------
|
*/
    $title_apl = 'POS Kasir';

/*
|--------------------------------------------------------------------------
| BASE SITE URL
|--------------------------------------------------------------------------
|
*/
    global $baseURL;
    $baseURL = ((isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == "on") ? "https" : "http");
    $baseURL .= "://" . $_SERVER['HTTP_HOST'];
    $baseURL .= str_replace(basename($_SERVER['SCRIPT_NAME']), "", $_SERVER['SCRIPT_NAME']);
    
    // $baseURL  = "http://localhost/testing/crud-php-generator/";

/*
|--------------------------------------------------------------------------
| Date Default Timezone SET
|--------------------------------------------------------------------------
|
*/
    date_default_timezone_set("Asia/Jakarta");

/*
|--------------------------------------------------------------------------
| Error Reporting
|---------------------------------------------  -----------------------------
|
*/
// ini_set('display_errors', E_ALL);
// ini_set('display_startup_errors', E_ALL);
// error_reporting(E_ALL);
// ini_set('log_errors', E_ALL);
error_reporting(0);

Bagian yang perlu disesuaikan:

$host     = "localhost";
$user     = "root";
$pass     = "";
$dbname   = "codekop_pos_kasir";

✅ Pada sebagian besar shared hosting cPanel, hostname database menggunakan localhost.
❌ Jangan menggunakan username database root dengan password kosong karena konfigurasi tersebut biasanya hanya digunakan pada XAMPP di komputer lokal.

🔗 8. Mengatur URL Aplikasi

Beberapa versi aplikasi memiliki pengaturan URL utama atau base_url.

Contoh konfigurasi default yang sudah menyesuaikan berbagai tempat hosting atau local :

$baseURL = ((isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == "on") ? "https" : "http");
$baseURL .= "://" . $_SERVER['HTTP_HOST'];
$baseURL .= str_replace(basename($_SERVER['SCRIPT_NAME']), "", $_SERVER['SCRIPT_NAME']);

Boleh ubah menjadi alamat domain atau subdomain hosting.

Contoh menggunakan subdomain

$baseURL = 'https://kasir.tokosaya.com/';

Contoh menggunakan folder

$baseURL = 'https://tokosaya.com/kasir/';
⚠️ Pastikan penggunaan garis miring / di akhir URL sesuai dengan struktur aplikasi.

🐘 9. Memilih Versi PHP

Buka menu:

cPanel → Software → MultiPHP Manager

Pilih domain atau subdomain aplikasi, kemudian gunakan versi PHP yang sesuai dengan kebutuhan Source Code POS Kasir.

⚠️ Jangan langsung memilih versi PHP terbaru apabila versi aplikasi belum mendukungnya.

Langkah memilih versi PHP:

  1. Centang domain atau subdomain aplikasi.
  2. Pilih versi PHP yang sesuai.
  3. Klik tombol Apply.

Pastikan beberapa ekstensi PHP berikut tersedia jika dibutuhkan:

pdo
pdo_mysql
mysqli
mbstring
json
fileinfo
gd
zip
curl
openssl

Ketersediaan ekstensi bergantung pada konfigurasi penyedia hosting.

🔑 10. Mengatur Permission File dan Folder

Umumnya permission yang aman adalah:

Folder: 755
File: 644

Folder tertentu yang digunakan untuk upload gambar, backup, atau penyimpanan dokumen mungkin memerlukan akses tulis.

Contoh folder tersebut:

assets/uploads

Cara mengubah permission:

  1. Klik kanan file atau folder.
  2. Pilih menu Change Permissions.
  3. Masukkan permission yang diperlukan.
  4. Klik tombol Change Permissions.
🚫 Hindari menggunakan permission 777 kecuali benar-benar diperlukan dan Anda sudah memahami risikonya.

🔒 11. Mengaktifkan HTTPS

Aplikasi POS Kasir menyimpan data bisnis dan menggunakan halaman login. Oleh karena itu, gunakan HTTPS agar koneksi ke server lebih aman.

Buka menu:

cPanel → Security → SSL/TLS Status

Pastikan domain sudah memiliki sertifikat SSL aktif. Setelah itu, buka menu Domains dan aktifkan:

Force HTTPS Redirect

Alamat aplikasi kemudian dapat diakses melalui:

https://kasir.tokosaya.com
✅ Pastikan alamat aplikasi di browser menampilkan ikon gembok.

🧪 12. Menguji Aplikasi POS Kasir

Setelah seluruh konfigurasi selesai, buka alamat aplikasi melalui browser.

https://kasir.tokosaya.com

Lakukan pengujian pada beberapa fungsi berikut:

✅ Halaman login dapat dibuka.
✅ Login administrator berhasil.
✅ Data barang dapat ditampilkan.
✅ Transaksi penjualan dapat disimpan.
✅ Stok barang dapat diperbarui.
✅ Laporan penjualan dapat dibuka.
✅ Gambar produk dapat diunggah.
✅ Struk dapat dicetak.
💡 Lakukan minimal satu transaksi percobaan sebelum aplikasi digunakan untuk operasional toko.

🛠️ Mengatasi Masalah yang Sering Terjadi

Pesan error yang mungkin muncul:

Access denied for user

Atau:

Unknown database

Periksa kembali beberapa bagian berikut:

  • Nama database lengkap.
  • Username database lengkap.
  • Password database.
  • Hostname database.
  • Hak akses user terhadap database.

Pastikan prefix username cPanel ikut ditulis.

usernamecpanel_poskasir

Bukan hanya:

poskasir

Error 500 dapat disebabkan oleh:

  • Versi PHP tidak sesuai.
  • Ekstensi PHP belum aktif.
  • Kesalahan pada file .htaccess.
  • Permission file tidak sesuai.
  • Konfigurasi database salah.
  • Fungsi PHP lama sudah tidak didukung.

Periksa menu Errors pada cPanel atau file berikut:

error_log

Halaman putih biasanya terjadi karena PHP mengalami error, tetapi pengaturan display_errors sedang dinonaktifkan.

Aktifkan error reporting untuk pengujian sementara:

<?php
```

ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
```

Setelah masalah selesai, nonaktifkan kembali:

<?php
```

ini_set('display_errors', '0');
```
⚠️ Jangan menampilkan detail error pada aplikasi yang sudah digunakan secara publik.

Periksa konfigurasi base URL dan lokasi folder assets.

Pastikan URL tidak masih mengarah ke localhost:

http://localhost/poskasir/

Ubah menjadi alamat hosting:

https://kasir.tokosaya.com/

Server Linux membedakan huruf besar dan kecil pada nama file.

Logo.png
```

logo.png
```

Kedua nama file tersebut dianggap sebagai file yang berbeda.

  • Pastikan file index.php berada di document root.
  • Pastikan file .htaccess ikut terunggah.
  • Pastikan document root domain sudah benar.
  • Pastikan folder aplikasi tidak bertingkat.
  • Pastikan fitur rewrite didukung hosting.
  • Aktifkan opsi Show Hidden Files pada File Manager.

Periksa permission folder upload dan konfigurasi PHP:

upload_max_filesize
```

post_max_size
file_uploads
```

Pastikan ukuran file tidak melebihi batas hosting dan gunakan nama file tanpa karakter khusus.

Masalah ini dapat disebabkan oleh:

  • Session PHP tidak tersimpan.
  • Akses HTTP dan HTTPS tercampur.
  • Konfigurasi cookie tidak sesuai.
  • Folder session server bermasalah.
  • Base URL masih mengarah ke localhost.

Pastikan seluruh akses sudah menggunakan HTTPS, kemudian hapus cache dan cookie browser.

🛡️ Pengamanan Setelah Instalasi

  1. Hapus file ZIP dari hosting.
  2. Hapus file database .sql dari folder publik.
  3. Ganti password administrator bawaan.
  4. Gunakan password database yang kuat.
  5. Jangan membagikan konfigurasi database.
  6. Nonaktifkan tampilan error pada aplikasi produksi.
  7. Aktifkan SSL dan HTTPS.
  8. Buat backup database secara rutin.
  9. Gunakan akun pengguna sesuai tugas masing-masing.
  10. Jangan memasang file atau plugin dari sumber tidak dikenal.
🚨 Jangan membiarkan file database SQL berada di dalam public_html karena file tersebut dapat berisi struktur dan data penting aplikasi.

💾 Backup Aplikasi POS Kasir

Data transaksi merupakan bagian penting dari operasional bisnis. Buat backup secara rutin melalui cPanel.

Data yang perlu dicadangkan:

  • 📁 File source code.
  • 🖼️ Folder upload gambar.
  • 🗄️ Database MySQL atau MariaDB.
  • ⚙️ File konfigurasi aplikasi.

Cara export database melalui phpMyAdmin:

  1. Pilih nama database.
  2. Klik menu Export.
  3. Pilih metode Quick.
  4. Pilih format SQL.
  5. Klik tombol Export.
☁️ Simpan file backup di komputer atau penyimpanan lain. Jangan hanya menyimpan backup di hosting yang sama.

✅ Kesimpulan

Memasang Source Code POS Kasir Codekop ke hosting cPanel terdiri dari beberapa tahapan utama:

1️⃣ Menyiapkan domain atau subdomain.
2️⃣ Mengunggah source code ke File Manager.
3️⃣ Membuat database dan user MySQL.
4️⃣ Mengimpor file SQL melalui phpMyAdmin.
5️⃣ Mengatur koneksi database.
6️⃣ Menyesuaikan URL aplikasi.
7️⃣ Memilih versi PHP yang sesuai.
8️⃣ Mengaktifkan HTTPS.
9️⃣ Menguji seluruh fitur aplikasi.
🔟 Membuat backup secara berkala.

Setelah instalasi selesai, aplikasi POS Kasir dapat diakses secara online melalui browser tanpa harus menjalankan Apache dan MySQL dari XAMPP.

🚀 Gunakan hosting yang stabil, aktifkan HTTPS, dan lakukan backup secara rutin agar aplikasi POS Kasir dapat digunakan dengan aman untuk operasional bisnis.
Fauzan Falah
Tentang penulis
Fauzan Falah

Full-Stack Web Developer at Codekop.com.

Lihat Profil Kontak
Komentar