summaryrefslogtreecommitdiff
path: root/linux/deb/02-fs-spring-boot-kamal/README
diff options
context:
space:
mode:
authorKamal Wickramanayake <kamal@inbox.lk>2026-05-23 16:07:26 +0530
committerKamal Wickramanayake <kamal@inbox.lk>2026-05-23 16:07:26 +0530
commit161707cc2eab1d76a15684ef105bf1e2ecca154d (patch)
tree8db86611eaaeda22977d8ac71af0843ffc8a4aa5 /linux/deb/02-fs-spring-boot-kamal/README
parented1837534a0a9a1ab8f8291cff73be031a5d493b (diff)
Added a Spring Boot app packaged deb file creation sample project to linux/deb directory
Diffstat (limited to 'linux/deb/02-fs-spring-boot-kamal/README')
-rw-r--r--linux/deb/02-fs-spring-boot-kamal/README39
1 files changed, 39 insertions, 0 deletions
diff --git a/linux/deb/02-fs-spring-boot-kamal/README b/linux/deb/02-fs-spring-boot-kamal/README
new file mode 100644
index 0000000..aaf92bc
--- /dev/null
+++ b/linux/deb/02-fs-spring-boot-kamal/README
@@ -0,0 +1,39 @@
+This directory contains everything to build a deb package that bundles a Spring Boot app that starts a web server.
+
+The Spring Boot application has not been bundled with this. You need to build it seperately and put it in the correct directory (run build.sh for further details).
+
+To build, run the following command:
+
+ ./build.sh
+
+To install the build deb package run the following commands replacing the package.deb with the correct name of the deb file.
+
+ cp package.deb /tmp
+ cd /tmp
+ apt install ./package.deb
+
+The above "apt install" will download dependencies if needed. Otherwise, dpkg command can just be used to install or upgrade the package:
+
+ dpkg -i package.deb
+
+After installing the package, update the configuration file /etc/fs-spring-boot-kamal/application.yaml .
+
+Enable service to start at boot time:
+
+ systemctl enable fs-spring-boot-kamal
+
+Start service:
+
+ systemctl start fs-spring-boot-kamal
+
+View service log:
+
+ journalctl -u fs-spring-boot-kamal -f
+
+ (Press CTRL+C to terminate log viewing)
+
+Access the service:
+
+ http://server-ip-or-hostname:8085/
+
+ (Instead of 8085, use the port configured in application.yaml file)