내 컴퓨터용 myTickrs 다운로드

데스크톱 앱을 실행하는 방법은 세 가지입니다:

1. 설치하기: 내 시스템에 맞는 명령 한 줄로.
2. Docker로 실행하기: 내 컴퓨터나 홈 서버에서.
3. 소스에서 실행하기: GitHub의 코드로.

아무것도 설치하고 싶지 않으신가요? 대신 브라우저에서 myTickrs를 사용하세요.

1. 설치하기

터미널을 열고 내 시스템에 맞는 줄을 붙여 넣은 뒤 Enter를 누르세요. 설치 프로그램에는 Node.js 24 이상이 필요하며, 없거나 버전이 낮으면 먼저 묻고 대신 설치해 줍니다.

Windows

PowerShell을 열고(시작을 누르고 “PowerShell” 입력) 다음을 실행하세요:

macOS

터미널을 열고(응용 프로그램 → 유틸리티) 다음을 실행하세요:

Linux

터미널을 열고 다음을 실행하세요:

설치 프로그램이 하는 일

1. Node.js 24 이상이 있는지 확인합니다. 없으면 허락을 구한 뒤 설치합니다. Windows에서는 winget 또는 공식 설치 프로그램, macOS에서는 공식 설치 프로그램, Linux에서는 NodeSource(apt, dnf, yum) 또는 ~/.local/node에 공식 빌드를 사용합니다. Node.js를 설치할 때 관리자 암호를 물을 수 있습니다.
2. 최신 myTickrs를 다운로드하여 홈 폴더의 mytickrs 폴더에 압축을 풉니다(Windows는 %USERPROFILE%\mytickrs, macOS와 Linux는 ~/mytickrs). 다른 폴더를 쓰려면 실행 전에 MYTICKRS_DIR를 설정하세요.
3. 의존성을 설치하고 myTickrs 바로 가기를 추가합니다: Windows에서는 바탕 화면과 시작 메뉴에, macOS에서는 응용 프로그램과 바탕 화면 링크로, Linux에서는 애플리케이션 메뉴와 바탕 화면에 추가됩니다.
4. 앱을 시작하고 브라우저에서 엽니다. 브라우저가 열리지 않으면 http://localhost:5050으로 이동하세요.

스크립트 먼저 읽기

스크립트를 셸에 파이프로 넘기는 것은 그 스크립트를 신뢰한다는 뜻이므로, 실행하기 전에 읽어 보세요. 이 페이지의 명령이 다운로드하는 파일은 다음과 같습니다:

• install.ps1 (Windows)
• install-macos.sh (macOS)
• install-linux.sh (Linux)
• install-docker.ps1 (Windows의 Docker)
• install-docker.sh (macOS와 Linux의 Docker)

Windows와 macOS용 서명된 설치 프로그램을 준비 중이며, 그러면 터미널이 전혀 필요 없게 됩니다.

시작, 업데이트, 제거

나중에 다시 시작하기

myTickrs 바로 가기를 더블클릭하세요. 터미널 창에서 앱이 시작되고 브라우저가 열립니다. 앱이 이미 실행 중이면 브라우저만 열립니다. 앱을 멈추려면 그 창을 닫으세요(또는 창에서 Ctrl+C를 누르세요).

업데이트

앱을 멈춘 뒤 설치 줄을 다시 실행하세요. 새 버전이 이전 버전을 대체하며, 데이터베이스(data/), 설정(.env), 추가한 플러그인은 그대로 유지됩니다.

백업

포트폴리오는 설치 폴더의 data/tickrs.db 파일입니다. 백업하거나 다른 컴퓨터로 옮기려면 이 파일을 복사하세요. 설정 → 동기화에서 myTickrs 클라우드 계정과의 동기화를 켜서 백업과 복원에 쓸 수도 있습니다. 직접 켜지 않으면 꺼져 있습니다.

제거

앱을 멈춘 뒤 설치 폴더와 myTickrs 바로 가기를 삭제하세요. 데이터베이스도 함께 삭제되므로, 보관하려면 먼저 data/를 백업하세요.

2. Docker로 실행하기

Node.js를 설치하고 싶지 않거나, 홈 서버나 NAS에서 myTickrs를 쓰고 싶으신가요? 대신 Docker로 실행하세요. 이미지는 GitHub Container Registry의 ghcr.io/mytickrs/mytickrs이며, x86-64와 ARM(Apple 실리콘 포함)을 지원합니다.

Windows

PowerShell에서:

macOS와 Linux

터미널에서:

Docker 설치 프로그램이 하는 일:

1. Docker와 Docker Compose가 있는지 확인합니다. 없으면 허락을 구한 뒤 설치합니다. Windows(WSL 2 사용, Windows 재시작 필요)와 macOS에서는 Docker Desktop, Linux에서는 Docker Engine입니다. Docker가 실행 중이 아니면 시작합니다.
2. docker-compose.yml을 작성하여 홈 폴더의 mytickrs-docker 폴더에 넣은 뒤, 이미지를 다운로드하고 시작합니다. 다른 폴더를 쓰려면 실행 전에 MYTICKRS_DIR를 설정하세요.
3. 브라우저에서 앱을 엽니다(http://localhost:5050). 다른 포트를 쓰려면 실행 전에 MYTICKRS_PORT를 설정하세요.

이후 앱은 Docker가 시작될 때마다 함께 시작됩니다. 데이터(데이터베이스와, 저장된 제공업체 키를 암호화하는 키)는 mytickrs-docker 안의 data 폴더에 보관됩니다. 백업하려면 앱을 멈추고 그 폴더를 복사하세요. 업데이트하려면 같은 줄을 다시 실행하세요. 데이터는 유지됩니다. mytickrs-docker 폴더에서 docker compose stop과 docker compose start로 멈추고 시작하며, docker compose down -v로 제거합니다. 데이터는 직접 삭제할 때까지 data 폴더에 남아 있습니다.

이미 Docker를 쓰고 계신가요? 빈 폴더에서:

curl -fsSLO https://files.mytickrs.app/docker-compose.yml
docker compose up -d

3. 소스에서 실행하기

코드는 GitHub에 있습니다. Node.js 24로:

git clone https://github.com/myTickrs/myTickrs.git mytickrs
cd mytickrs
npm i
npm start

Visual Studio C++ 도구가 없는 Windows에서는 npm i --ignore-scripts를 사용하세요.

더 최신 시세를 무료로

시세는 기본적으로 Yahoo Finance에서 가져오며 키가 필요 없습니다. 비공식 소스라 늦을 수 있어 시세가 지연될 수 있습니다. 더 최신 시세를 원하면 Finnhub(최신 시세와 티커 검색)와 Twelve Data(일별 이력, 주식 분할, 배당금)에서 무료 계정을 만들고 설정 → 데이터 제공업체에 키를 추가하세요. 키는 내 컴퓨터에서 암호화됩니다.

다른 기기에서 사용하기

데스크톱 에디션에는 로그인이 없어, 접속할 수 있는 사람은 누구나 사용할 수 있습니다. .env에서 HOST를 바꾸지 않는 한 내 컴퓨터(127.0.0.1)에서만 수신합니다(Docker에서는 docker-compose.yml 옆의 .env에 MYTICKRS_BIND=0.0.0.0). 신뢰할 수 있는 네트워크에서만, 또는 자체 로그인이 있는 리버스 프록시 뒤에서만 그렇게 하세요.